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1.1 Z8 MCU FAMILY OVERVIEW 


The Zilog Z8® microcontroller product line continues to 
expand with new product introductions. Zilog MCU prod- 
ucts are targeted for cost-sensitive, high-volume applica- 
tions including consumer, automotive, security, and HVAC. 
It includes ROM-based products geared for high-volume 
production (where software is stable) and one-time pro- 
grammable (OTP) equivalents for prototyping as well as 
volume production where time to market or code flexibility 
is critical (Table 1-1). A variety of packaging options are 
available including plastic DIP, SOIC, PLCC, and QFP. 


1.1.1 Key Product Line Features 


m General-Purpose Register (GPR) File Architecture: 
Every RAM register acts like an accumulator, speeding 
instruction execution and maximizing coding efficiency. 
Working register groups allow fast context switching. 


m@ Flexible I/O: |/O byte, nibble, and/or bit programmable 
as inputs or outputs. Outputs are software 
programmable as open-drain or push-pull on a port 
basis. Inputs are Schmitt-triggered with auto latches 
to hold unused inputs at a known voltage state. 


@ Analog Inputs: Three input pins are software 
programmable as digital or analog inputs. When in the 
analog mode, two comparator inputs are provided with 
a common reference input. These inputs are ideal for 
a variety of common functions, including threshold 
level detection, analog-to-digital conversion, and short 
circuit detection. Each analog input provides a unique 
maskable interrupt input. 


m Timer/Counter(T/C): The T/C consists of a 
programmable 6-bit prescaler and 8-bit downcounter, 
with maskable interrupt upon end-of-count. Software 
controls T/C load/start/stop, countdown read (at any 
time on the fly), and maskable end-of-count interrupt. 
Special functions available include T,,, (external counter 
input, external gate input, or external trigger input) and 
Tour (external access to timer output or the internal 
system clock.) These special functions allow accurate 
hardware input pulse measurement and output 
waveform generation. 
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A generalized Z8 MCU block diagram is shown in 
Figure 1-1. The same on-chip peripherals are used across 
the MCU product line with the primary differences being 
the amount of ROM/RAM, number of I/O lines present, and 
packaging/temperature ranges available. This allows 
code written for one MCU device to be easily ported to 
another family member. 


m Interrupts: There are six vectored interrupt sources 
with software-programmable enable and priority for 
each of the six sources. 


m@ Watch-Dog Timer (WDT): An internal WDT circuit is 
included as a fail-safe mechanism so that if software 
strays outside the bounds of normal operation, the 
WDT will timeout and reset the MCU. To maximize 
circuit robustness and reliability, the default WDT clock 
source is an internal RC circuit (isolated from the 
device clock source). 


m@ Auto Reset/Low-Voltage Protection: All family 
devices have internal Power-On Reset. ROM devices 
add low-voltage protection. Low-voltage protection 
ensures the MCU is in a known state at all times (in 
active RUN mode or RESET) without external hardware 
(or a device reset pin). 


m= Low-EMI Operation: Mode is programmable via 
software or as amaskoption. This new option provides 
for reduced radiated emission via clock and output 
drive circuit changes. 


m Low-Power: CMOS with two standby modes; STOP 
and HALT. 


m Full Z8 Instruction Set: Forty-eight basic instructions, 
supported by six addressing modes with the ability to 
operate on bits, nibbles, bytes, and words. 
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Figure 1-1. Z8® MCU Block Diagram 
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1.1.2 Product Development Support 


The Z8® MCU productline is fully supported with a range of 


cross assemblers, C compilers, ICEBOX emulators, single 
and gang OTP/EPROM programmers, and software simu- 
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The Z86CCPOOZEM low-cost Z8 CCP™ real-time emula- 
tor/programmer kit was designed specifically to support 
all the products outlined in Table 1-1. 








lators. 
Table 1-1. Zilog General-Purpose Microcontroller Product Family 

PRODUCT ROM/ \W/0 TiC §AN INT WDT POR Vbo_ RC SPEED PIN 

RAM IN (MHz) COUNT 
Z86C03 512/60 14 1 2 6 F Y Y Y 8 18 
Z86C03 512/60 14 1 2 6 F Y N Y 8 18 
Z86C04 1K/124 14 2 2 6 F Y ¥ N 8 18 
Z86E04 1K/124 14 2 2 6 F Y N N 8 18 
Z86C06 1K/124 14 2 2 6 P Y Y y. 12 18 
Z86E06 1K/124 14 2 2 6 P Y N Y 12 18 
Z86C08 2K/124 14 2 2 6 F Y Y N 12 18 
Z86E08 2K/124 14 2 2 6 F ¥ N N 12 18 
Z86C30 4K/236 24 2 2 6 P Y Y bg 12 28 
Z86E30 A4K/236 24 2 2 6 P 2 N 7 12 28 
Z86C31 2K/124 24 2 2 6 P Y Y ¥ 8 28 
Z86E3 1 2K/124 24 2 2 6 P Y N Y 8 28 
Z86C40 AK/236 32 2 2 6 P Y Y Y 12 40/44 
Z86E40 4K/236 32 2 2 6 P Y N Y 12 40/44 





Note: Z86Cxx signify ROM devices; Z86Exx signify EPROM devices; F = fixed; P = programmable. 


A Z8 CCP Emulator Accessory Kit (Z8CCPOOZAC) is also 
available and provides an RS-232 cable and power cable 
along with the 28- and 40- pin ZIF scckets and 28 and 40 
pin target connector cables required to emulate/program 
28/40 pin devices. 


The Z86CCPOOZEM kit comes with: 


m Z8 CCP Emulator/Programmer Module 


18-pin Target Connection Cable 


WINDOWS-based GUI Host Software 


DOS-based ZASM LINKER/LOADER 


Documentation: ZBMOBJ Linker/Loader User’s Guide, 
Z8 Cross Assembler User’s Guide, Z8 Emulator GUI 
User’s Guide, Discrete Z8 MCU Product Specifications 
Databook, and Z8 MCU Technical Manual. 








O =—iLCis USER'S MANUAL 


CHAPTER 2 





ADDRESS SPACE i 
2.1 INTRODUCTION 
Four address spaces are available for the Z8® addresses for control and data registers for additional 
microcontroller: peripherals/features. 


™ The Z8 Standard Register File contains addresses for ™@ 28 External Program Memory contains addresses for 


peripheral, control, all general-purpose, and all I/O all memory locations having executable code and/or 

port registers. This is the default register file data. 

specification. 

m 28 External Data Memory contains addresses for all 
m The Z8 Expanded Register File (ERF) contains memory locations that hold data only, whether internal 
or external. 

2.2 Z8 STANDARD REGISTER FILE Table 2-1. Z8 Standard Register File 
The Z8 Standard Register File totals up to 256 consecutive Hex Register Register 
bytes (Registers). The register file consists of 4 /O ports Address Description Identifier 


(OOH-03H), 236 General-Purpose Registers (04H-EFH), 


and 16 control registers (FOH-FFH). Table 2-1 shows the : sa de he nie 

layout of the register file, including register names, loca- ots One NG yle 

tions, and identifiers. FD Register Pointer RP 

FC Program Control Flags FLAGS 

FB Interrupt Mask Register IMR 
FA Interrupt Request Register IRQ 
FQ Interrupt Priority Register IPR 
F8 Port 0-1 Mode Register POIM 
F7 Port 3 Mode Register P3M 
F6 Port 2 Mode Register P2M 
F5 TO Prescaler PREO 
F4 Timer/Counter 0 T0 
F3 T1 Prescaler PRE1 
F2 Timer/Counter 1 11 
FY Timer Mode TMR 
FO Serial 1/0 S10 


EF R239 


General-Purpose Registers (GPR) 


04 R4 
03 Port 3 P3 
02 Port 2 p2 
01 Port 1 Py 
00 Port 0 PO 


Note: Refer to the product specification to determine which 
registers are available for use on any specific device. 
DB Ne Ea on a eer aI aS Se NG RR ES ISN GI aT RR MS I PN ANAT TSP TN Rea NEA SP a AN Ne ca ee EE eT] 
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2.2 Z8 STANDARD REGISTER FILE (Continued) 


Registers can be accessed as either 8-bit or 16-bit regis- 
ters using Direct, Indirect, or Indexed Addressing. All 236 
general-purpose registers can be referenced or modified 
by any instruction that accesses an 8-bit register, without 
the need for special instructions. Registers accessed as 
16 bits are treated as even-odd register pairs (there are 
118 valid pairs). In this case, the data’s Most Significant 
Byte (MSB) is stored in the even numbered register, while 
the Least Significant Byte (LSB) goes into the next higher 
odd numbered register (Figure 2-1). 


Rn Rn+1 


n = Even Address 


Figure 2-1. 16-Bit Register Addressing 


By using a logical instruction and a mask, individual bits 
within registers can be accessed for bit set, bit clear, bit 
complement, or bit test operations. For example, the 
instruction AND R15, MASK performs a bit clear operation. 
Figure 2-2 shows this example. 


ol yy fofofofo] ars 
Ps pop tsps f [sy mask 


AND R15, DFH 


ol pops fofofofol ars 


Figure 2-2. Accessing Individual Bits (Example) 


;Clear Bit 5 of Working Register 15 


When instructions are executed, registers are read when 
defined as sources and written when defined as destina- 
tions. All General-Purpose Registers function as accumu- 
lators, address pointers, index registers, stack areas, or 
scratch pad memory. 


2.2.1 General-Purpose Registers 


General-Purpose Registers (GPR) are undefined after the 
device is powered up. The registers keep their last value 
after any reset, as long as the reset occurs in the V,, 
voltage-specified operating range. It will not keep its last 
state from a V,, reset if V,, drops below 1.8v. 


Note: Registers in Bank EO-EF may only be accessed 
through the working register and indirectaddressing modes. 
Direct access cannot be used because the 4-bit working 
register address mode already uses the format [E | dst], 
where dst represents the working register number from OH 
to FH. 


2.2.2 RAM Protect 


The upper portion of the register file address space 80FH 
to EFH (excluding the control registers) may be protected 
from reading and writing. The RAM Protect bit option is 
mask-programmable and is selected by the customer 
when the ROM code is submitted. After the mask option is 
selected, the user activates this feature from the internal 
ROM code to turn off/on the RAM Protect by loading either 
aQOor 1 into the IMR register, bitD6. A 1 in D6 enables RAM 
Protect. Only devices that use registers 80H to EFH offer 
this feature. 


2.2.3 Working Register Groups 


Z8® instructions can access 8-bit registers and register 
pairs (16-bit words) using either 4-bit or 8-bit address 
fields. 8-bit address fields refer to the actual address of the 
register. For example, Register 58H is accessed by calling 
upon its 8-bit binary equivalent, 01011000 (58H). 


With 4-bit addressing, the register file is logically divided 
into 16 Working Register Groups of 16 registers each, as 
shown in Table 2-2. These 16 registers are known as 
Working Registers. A Register Pointer (one of the control 
registers, FDH) contains the base address of the active 
Working Register Group. The high nibble of the Register 
Pointer determines the current Working Register Group. 


When accessing one of the Working Registers, the 4-bit 
address of the Working Register is combined within the 
upper four bits (high nibble) of the Register Pointer, thus 
forming the 8-bit actual address. Figure 2-3 illustrates this 
operation. Since working registers are typically specified 
by short format instructions, there are fewer bytes of code 
needed, which reduces execution time. In addition, when 
processing interrupts or changing tasks, the Register 
Pointer speeds context switching. A special Set Register 
Pointer (SRP) instruction sets the contents of the Register 
Pointer. 
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Table 2-2. Working Register Groups 
Register Pointer Working Actual 


(FDH) Register Group Registers 
High Nibble (HEX) (HEX) 
1111(B) 'S FO-FF 
1110(B) E EO-EF 
1101(B) D DO-DF 
1100(B) C CO-CF 
1011(B) B BO-BF 
1010(B) A AO-AF 
1001(B) 9 90-9F 
1000(B) 8 80-8F 
0111(B) 7 70-7F 
0110(B) 6 60-6F 
0101(B) 5 50-5F 
0100(B) 4 40-4F 
0011(B) 3 30-3F 
0010(B) 2 20-2F 
0001(B) 1 10-1F 
0000(B) 0 00-OF 





fe ee ta 0 | 0 | 0 | 0 | Register Pointer (FDH), Standard Register File 
fo. ER ba 0 | 4 | a io INC R6 (Instruction, Short Format) 


fo oe ae Aa fe, a1 0 | Actual Register Address (76H) 


Figure 2-3. Working Register Addressing Examples 
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| 


R253 
7 6 15 14 fae (Register Pointer) 


The upper nibble of the register file address 
provided by the register pointer specifies 
the active working-register group. 


Working Register Group F 








te ee ee wae reese 
i 









The lower nibble 





40 of the register 

ae 3F Specified Working Ledyrstal ey = 
: 30 Register Group instruction points 
s oF to the specified 
: 20 
. 1F 
as ic Working Register Group 1 R15 to RO 
8 
; ad Working Register Group 0 R15 to R4 

R3 to RO 





Figure 2-4. Register Pointer 


Note: The full register file is shown. Please refer to the selected device product specification for actual file size. 


2.2.4 Error Conditions 


Registers in the Z8® Standard Register File must be cor- m& Writing to bits that are defined as timer output, serial 
rectly used because certain conditions produce inconsis- output, or handshake output will have no effect. 
tent results and should be avoided. 
m The Z8 instruction DJNZ uses any general-purpose 
m Registers F3H and F5H-F9H are write-only registers. If working register as a counter. 
an attempt is made to read these registers, FFH 
is returned. Reading any write-only register willreturn & Logical instructions such as OR and AND require that 
FFH. the current contents of the operand be read. They 
therefore will not function properly on write-only 
m Whenregister FDH (Register Pointer) is read, the least registers. 
significant four bits (lower nibble) will indicate the 
current Expanded Register File Bank. (Example: 0000 =m& TheWDTMRregister must be written within the first 64 
indicates the Standard Register File, while 1010 internal system clocks (SCLK) of operation after a 
indicates Expanded Register File Bank A.) reset. 
m@ When Ports O and 1 are defined as address outputs, 


registers OOH and 01H will return 1s in each address 
bit location when read. 
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2.3 Z8 EXPANDED REGISTER FILE 


The standard register file of the Z8® has been expanded to 
form 16 Expanded Register File (ERF) Banks (Figure 2-5). 
Each ERF Bank consists of up to 256 registers (the same 
amount as in the Standard Register File) that can then be 


REGISTER POINTER 


7] sf 5} 4} atest 0) 


Working Register 
Group Pointer 









Group Pointer 


Expanded Register 
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divided into 16 Working Register Groups. This expansion 
allows for access to additional feature/peripheral control 
and data registers. 


EXPANDED REGISTER FILE 
BANK 
(F) OF WDTMR 


(F) OE R 
(F) 0D R 


aD 
4 


ahs 
2 
g 3 
a8 


5 


lg 
31> 


(F) OA 
(F) 09 


ah 


(F) 07 Rese 


2/8 [s 
HE 


(F) 05 





Z8 Register File | (04s Reserved 
7 rT 
=a 
Sarai 
ee 00 POON 
ee ae eet EXPANDED REGISTER FILE 
Lo a 
aes 
| ——— 
ie | 
aa 
a = 
ae —. 006 Reserved 
a 
ee 1) 
oF a ap 
00 
(C) 03 Reserved 





EXPANDED iy FILE 


BANK (0) 

0) OF GPR 

0) OD GPR 

0) 09 GPR 

0) 08 GPR 
Los PS 
Poo 
Lo Pr 


Figure 2-5. Expanded Register File Architecture 


Note: The fully implemented register file is shown. Please refer to the specific product specification for actual register file architecture 


implemented. 
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Currently, three out of the possible sixteen Z8® ERF Banks 
have been implemented. ERF Bank0O, also known as the Z8 
Standard Register File, has all 256 bytes defined (Figure 2- 
1). Only Working Register Group 0 (register addresses 
QOH to OFH) have been defined for ERF Bank C and ERF 
Bank F (Table 2-4). All other working register groups in ERF 
Banks C and F, as well as the remaining thirteen ERF 
Banks, are not implemented. All are reserved for future 
use. 


When an ERF Bank is selected, register addresses 00H to 
OFH access those sixteen ERF Bank registers - in effect 
replacing the first sixteen locations of the Z8 Standard 
Register File. 


For example, if ERF Bank C is selected, the Z8 Standard 
Registers OOH through OFH are no longer accessible. 
Registers OOH through OFH are now the 16 registers from 
ERF Bank C, Working Register Group 0. No other Z8 
Standard Registers are effected since only Working Reg- 
ister Group 0 is implemented in ERF Bank C. 


Access to the ERF is accomplished through the Register 
Pointer (FDH). The lower nibble of the Register Pointer 
determines the ERF Bank while the upper nibble deter- 
mines the Working Register Group within the register file 
(Figure 2-6). 


Working Expanded 

Register Register 
Group Bank 
Selects ERF Bank A(k), 


Working Register Group 7(H) 


Figure 2-6. Register Pointer (FDH) Example 


The value of the lower nibble in the Register Pointer (FDH) 
corresponds to the ERF Bank identification. Table 2.3 
shows the lower nibble value and the register file assigned 
to it. 


(FDH) 


Low Nibble 


0000(B) 
0001(B) 
0010(B) 
0011(B) 
0100(B) 


0101(B) 
0110(B) 
0114(B) 
1000(B) 


1001(B) 
1010(B) 
1011(B) 
1100(B) 


1101(B) 
1110(B) 
1111(B) 
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Table 2-3. ERF Bank Address 


Register Pointer 


Hex 


MMO] OWYrO!l Ono] BWDhY-O 


Register File 


Z8® Standard Register File * 

Expanded Register File Bank 1 
Expanded Register File Bank 2 
Expanded Register File Bank 3 
Expanded Register File Bank 4 


Expanded Register File Bank 5 
Expanded Register File Bank 6 
Expanded Register File Bank 7 
Expanded Register File Bank 8 


Expanded Register File Bank 9 
Expanded Register File Bank A 
Expanded Register File Bank B 
Expanded Register File Bank C 


Expanded Register File Bank D 
Expanded Register File Bank E 
Expanded Register File Bank F 





Note: The Z8 Standard Register File is equivalent to Expanded 
Register File Bank 0. 


A 2iLCS 


The upper nibble of the register pointer selects which 
group of 16 bytes in the Register File, out of the full 256, will 
be accessed as working registers. 


For example: 
(See Figure 2-4) 
R253 RP = OOH -ERF Bank 0, Working Reg. Group 0. 
RO = Port O = OOH 

R1 = Port 1 =01H 

R2 = Port 2 = 02H 

R3 = Port 3 = 03H 

R11 = GPR OBH 

R15 = GPR OFH 

If: 

R253 RP =OFH — ;ERF Bank F, Working Reg. Group 0. 
RO = PCON = 00H 

R1 = Reserved = 01H 

R2 = Reserved = 02H 

R11 = SMR = OBH 

R15 = WDTMR = OFH 


If: 

R253 RP = FFH ‘-ERF Bank F, Working Reg. Group F. 
OOH = PCON 

RO=S!i0 01H= Reserved 
Ri=TMR O2H= Reserved 


R2=T1  OBH=SMR 


R15 = SPL OFH =WDTMR 


Note that since enabling an ERF Bank (C or F) only 
changes register addresses 00H to OFH, the working 
register pointer can be used to access either the selected 
ERF Bank (Bank C or F, Working Register Group 0) or the 
Z8 Standard Register File (ERF Bank 0, Working Register 
Groups 1 through F). 


Note: When an ERF Bank other than Bank 0 is enabled, the first 
16 bytes of the Z8 Standard Register File (I/O ports 0 to 3, Groups 
4 to F) are no longer accessible (the selected ERF Bank, Regis- 
ters OOH to OFH are accessed instead). It is important to re- 
initialize the Register Pointer to enable ERF Bank 0 when these 
registers are required for use. 


The SPI register is mapped into ERF Bank C. Access is 
easily done using the following example: 


LD RP, #40CH ‘Select ERF Bank C working 
;register group O for access. 

LD R2,#xx saccess SCON 

LD R1, #xx saccess RXBUF 

LD RP, #00H ‘Select ERF Bank O so I/O ports 


‘are again accessible. 
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Table 2-4. Z8 Expanded Register File Bank Layout 


Expanded 
Register File 
Bank ERF 
F(H) PCON, SMR, WDT, 
(OOH, OBH, OFH), 
Working Register Group 0 
only implemented. 
E(H) Not Implemented 
(Reserved) 
D(H) Not Implemented 
(Reserved) 
C(H) SPI Registers: SCOMP, 
RXBUF, 
SCON (00H, 01H, 02H), 
Working Register Group 0 
only implemented. 
B(H) Not Implemented 
(Reserved) 
A(H) Not Implemented 
(Reserved) 
9(H) Not Implemented 
(Reserved) 
8(H) Not Implemented 
(Reserved) 
7(H) Not Implemented 
(Reserved) 
6(H) Not Implemented 
(Reserved) 
5(H) Not Implemented 
(Reserved) 
4(H) Not Implemented 
(Reserved) 
3(H) Not Implemented 
(Reserved) 
2(H) Not Implemented 
(Reserved) 
1(H) Not Implemented 
(Reserved) 
O(H) Z8 Ports 0, 1, 2, 3, 


and General-Purpose Registers 
04H to EFH, and control registers 
FOH to FFH. 


Please refer to the specific product specification to deter- 
mine the above registers are implemented. 
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2.4 Z8 CONTROL AND PERIPHERAL 
REGISTERS 


2.4.1 Standard Z8 Registers 


The standard Z8® control registers govern the operation of 
the CPU. Any instruction which references the register file 
canaccess these control registers. Available control regis- 
ters are: 


Interrupt Priority Register (IPR) 
Interrupt Mask Register (IMR) 
Interrupt Request Register (IRQ) 
Program Control Flags (FLAGS) 
Register Pointer (RP) 

Stack Pointer High-Byte (SPH) 
Stack Pointer Low-Byte (SPL) 


The Z8 uses a 16-bit Program Counter (PC) to determine 
the sequence of current program instructions. The PC is not 
an addressable register. 


Peripheral registers are used totransfer data, configure the 
operating mode, and control the operation of the on-chip 
peripherals. Any instruction that references the register file 
can access the peripheral registers. The peripheral regis- 
ters are: 


Serial I/O (SIO) 

Timer Mode (TMR) 
Timer/Counter 0 (TO) 
TO Prescaler (PREO) 
Timer/Counter 1 (T1) 
T1 Prescaler (PRE1) 
Port 0-1 Mode (PO1M) 
Port 2 Mode (P2M) 
Port 3 Mode (P3M) 


In addition, the four port registers (PO-P3) are considered 
to be peripheral registers. 
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2.4.2 Expanded Z8 Registers 


The expanded Z8 control registers govern the operation of 
additional features or peripherals. Any instruction which 
references the register file can access these registers. 


The ERF contains the control registers for WDT, Port 
Control, Serial Peripheral Interface (SPI), and the SMR 
functions. Figure 2-4 shows the layout of the Register 
Banks in the ERF. Register Bank C in the ERF consists of 
the registers for the SPI. Table 2-5 shows the registers 
within ERF Bank C, Working Register Group O. 


Table 2-5. Expanded Register File Register Bank C, 


WR Group 0 
Register Working 
Register Function Register 
F Reserved R15 
E Reserved R14 
D Reserved R13 
C Reserved R12 
B Reserved R11 
A Reserved R10 
9 Reserved R9 
8 Reserved R8 
7 Reserved R7 
6 Reserved R6 
5 Reserved R5 
4 Reserved R4 
3 Reserved R3 
2 SPI Control (SCON) R2 
1 SPI Tx/Rx Data (RxBuf) R1 
0 SPI Compare (SCOMP) RO 
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Working Register Group 0 in ERF Bank 0 consists of the 
registers for Z8 General-Purpose Registers and ports. 


Table 2-6 shows the registers within this group. 


Table 2-6. Expanded Register File Bank 0, 


Register 


OH NOW); ANON! COPD] OUMMT 


WR Group 0 


Register 
Function 


General-Purpose Register 
General-Purpose Register 
General-Purpose Register 
General-Purpose Register 


General-Purpose Register 
General-Purpose Register 
General-Purpose Register 
General-Purpose Register 


General-Purpose Register 
General-Purpose Register 
General-Purpose Register 
General-Purpose Register 


Port 3 
Port 2 
Port 1 
Port 0 


Working 
Register 
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Working Register Group O in ERF Bank F consists of the 
control registers for STOP mode, WDT, and port control. 
Table 2-7 shows the registers within this group. 


Table 2-7. Expanded Register File Bank F, 


Register 


oS — PO hon ~i oor wm co Oomnn 


Register 
Function 


WDTMR 
Reserved 
Reserved 
Reserved 


SMR 

Reserved 
Reserved 
Reserved 


Reserved 
Reserved 
Reserved 
Reserved 


Reserved 
Reserved 
Reserved 
PCON 


Working 
Register 


R15 
R14 
R13 
R12 


R11 
R10 
R9 
R8 


The functions and applications of the control and peripheral 
registers are described in subsequent sections of this 


manual. 
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2.5 PROGRAM MEMORY 


The first 12 bytes of Program Memory are reserved for the 
interrupt vectors (Figure 2-7). These locations contain six 
16-bit vectors that correspond to the six available inter- 
rupts. Address 12 up to the maximum ROM address 
consists of on-chip mask-programmable ROM. See the 
product data sheet for the exact program, data, register 
memory size, and address range available. At addresses 
outside the internal ROM, the Z8® executes external pro- 
gram memory fetches through Port O and Port 1 in Ad- 
dress/Data mode for devices with Port O and Port 1 
featured. Otherwise, the program counter will continue to 
execute NOPs up to address FFFFH, roll over to OOOOH, 
and continue to fetch executable code (Figure 2-7). 


65535 











4096 
4095 


Location of 
First Byte of 
Instruction 
Executed 
After RESET 


Interrupt 
Vector 
(Lower Byte) 


Interrupt 
Vector 
(Upper Byte) 


External 
ROM and RAM 


On-Chip 
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The internal program memory is one-time programmable 
(OTP) or mask programmable dependent on the specific 
device. A ROM protect feature prevents “dumping” of 
the ROM contents by inhibiting execution of the LDC, 
LDC, LDE, and LDEI instructions to Program Memory 
in all modes. ROM look-up tables cannot be used with 
this feature. 


The ROM Protect option is mask-programmable, to be 
selected by the customer when the ROM code is submit- 
ted. For the OTP ROM, the ROM Protect option is an OTP 
programming option. 





Figure 2-7. Z8 Program Memory Map 
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2.6 Z8 EXTERNAL MEMORY 


The Z8®, in some cases, has the capability to access 
external program memory with the 16-bit Program Counter. 
To access external program memory the Z8 offers multi- 
plexed address/data lines (AD7-ADO) on Port 1 and ad- 
dress lines (A15-A8) on Port O. This feature only applies to 
devices that offer Port O and Port 1. The maximum external 
address is FFFF. This memory interface is supported by 
the control lines /AS (Address Strobe), /DS (Data Strobe), 
and R/W (Read/Write). The origin of the external program 
memory starts after the last address of the internal ROM. 
Figure 2-8 shows an example of external program memory 
for the Z8. 


65535 
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2.6.1 External Data Memory (/DM) 


The Z8, in some cases, can address up to 60 Kbytes of 
external data memory beginning at location 4096. External 
Data Memory may be included with, or separated from, the 
external Program Memory space. /DM, an optional |/O 
function that can be programmed to appear on pin P34, is 
used to distinguish between data and program memory 
space. The state of the /DM signal is controlled by the type 
of instruction being executed. An LDC opcode references 
Program (/DM inactive) Memory, and an LDE instruction 
references Data (/DM active Low) Memory. The user must 
configure Port 3 Mode Register (P3M) bits D3 and D4 for 
this mode. 


External 
Memory 


4096 
4095 


Not Addressable 





Figure 2-8. External Memory Map 


Note: For additional information on using external memory, see Chapter 10 of this manual. For exact memory addressing options 


available, see the device product specification. 
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2.7 Z8 STACKS 


Stack operations can occur in either the Z8® Standard 
Register File or external data memory. Under software 
control, Port 0-1 Mode register (F8H) selects the stack 
location. Only the General-Purpose Registers can be used 
for the stack when the internal stack is selected. 


The register pair FEH and FFH form the 16-bit Stack Pointer 
(SP), that is used for all stack operations. The stack 
address is stored with the MSB in FEH and LSB in FFH 
(Figure 2-9). 


FFH 

LOWER Byte | Stack Pointer Low 
FEH 

UPPER Byte Stack Pointer High 


Figure 2-9. Stack Pointer 


Top of Stack PCH 


Stack Contents 
After a Call 
Instruction 


Top of Stack 
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The stack address is decremented prior to a PUSH opera- 
tion and incremented after a POP operation. The stack 
address always points to the data stored on the top of the 
stack. The Z8® stack is areturn stack for CALL instructions 
and interrupts, as well as a data stack. 


During a CALL instruction, the contents of the PC are saved 
on the stack. The PC is restored during a RETURN instruc- 
tion. Interrupts cause the contents of the PC and Flag 
registers to be saved on the stack. The IRET instruction 
restores them (Figure 2-10). 


When the Z8 is configured for an internal stack (using the 
Z8 Standard Register File), register FFH serves as the 
Stack Pointer. The value in FEH is ignored. FEH can be 
used as a general-purpose register in this case only. 


An overflow or underflow can occur when the stack ad- 
dress is incremented or decremented during normal stack 
operations. The programmer must prevent this occur- 
rence or unpredictable operation will result. 





Stack Contents 
After an 
Interrupt Cycle 


Figure 2-10. Stack Operations 
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3.1 CLOCK 


The Z8® derives its timing from on-board clock circuitry 
connected to pins XTAL1 and XTAL2. The clock circuitry 
consists of an oscillator, a divide-by-two shaping circuit, 
and a clock buffer. Figure 3-1 illustrates the clock circuitry. 
The oscillator’s input is XTAL1 and its output is XTAL2. The 
clock can be driven by a crystal, a ceramic resonator, LC 
clock, RC, or an external clock source. 


3.1.1 Frequency Control 
In some cases, the Z8 has an EPROM/OTP option or a 


Mask ROM option bit to bypass the divide-by-two flip flop 
in Figure 3-1. This feature is used in conjunction with the 


3.2 CLOCK CONTROL 


Insome cases, the Z8 offers software control of the internal 
system clock via programming register bits. The bits are 
located in the Stop-Mode Recovery Register in Expanded 
Register File Bank F, Register OBH. This register selects 


SMR (F) 0B 


USER'S MANUAL 


CHAPTER 3 
CLOCK 


low EMI option. When low EMI is selected, the device 
output drive and oscillator drive is reduced to approxi- 
mately 25 percent of the standard drive and the divide-by- 
two flip flop is bypassed such that the XTAL clock fre- 
quency is equal to the internal system clock frequency. In 
this mode, the maximum frequency of the XTAL clock is 4 
MHz. Please refer to specific product specification for 
availability of options and output drive characteristics. 


p= hy « ED 


Buffer 


XTAL1 LI Internal 


XTAL2 [77 Clock 


Figure 3-1. Z8 Clock Circuit 


the clock divide value and determines the mode of Stop- 
Mode Recovery (Figure 3-2). Please refer to the specific 
product specification for availability of this feature/regis- 
ter. 


[07] bs] 0s} D4] pa} 2] D1} Do) 


* Default setting after RESET. 


L. SCLK/TCLK Divide by 16 
0 OFF ** 
1 ON 
External Clock Divide Mode by 2 


0 = SCLK/TCLK = XTAL/2* 
1 = SCLK/TCLK = XTAL 


** Default setting after RESET and STOP-Mode Recovery. 


Figure 3-2. Stop-Mode Recovery Register 
(Write-Only Except D7, Which is Read-Only) 
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3.2.1 SCLK/TCLK Divide-By-16 Select (D0) 


This bit of the SMR controls a divide-by-16 prescalar of 
SCLK/TCLK. The purpose of this control is to selectively 
reduce device power consumption during normal proces- 
sor execution (SCLK control) and/or HALT mode (where 
TCLK sources counter/timers and interrupt logic). 


3.2.2 External Clock Divide-By-Two (D1) 


This bit can eliminate the oscillator divide-by-two circuitry. 
When this bit is 0, SCLK (System Clock) and TCLK (Timer 
Clock) are equal to the external clock frequency divided by 
two. The SCLK/TCLK is equal to the external clock fre- 
quency when this bit is set(D1 = 1). Using this bit, together 
with D7 of PCON, further helps lower EMI (D7 (PCON) = 0, 
D1 (SMR) = 1). The default setting is 0. Maximum fre- 
quencyis4MHzwithD1 = 1 (Figure3-3). 


DI (SMA) 


DO ( SMY 





External © ock 


Figure 3-3. External Clock Circuit 


Z8® MICROCONTROLLERS 
3.3 Oscillator Control 


In some cases, the Z8® offers software control of the 
oscillator to select low EMI drive or standard drive. The 
selection is done by programming bit D7 of the Port 
Configuration (PCON) register (Figure 3-4). The PCON 
register is located in Expanded Register File Bank F, 
Register OOH. 


A 1 in bit D7 configures the oscillator with standard drive, 
while a O configures the oscillator with Low EMI drive. This 
only affects the drive capability of the oscillator and does 
not affect the relationship of the XTAL clock frequency to 
the internal system clock (SCLK). 


PCON (FH) 00H 


[07] 6} 0s} D4] pa] ba} 01 | bo) 


Low EMI Oscillator 
0 Low EMI 
1 Standard 


Figure 3-4. Port configuration register (PCON 
(Write-Only) 
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3.4 OSCILLATOR OPERATION 


The Z8® uses a Pierce oscillator with an internal feedback 
(Figure 3-5). The advantages of this circuit are low cost, 
large output signal, low-power level in the crystal, stability 
with respect to V,,. and temperature, and low impedances 
(not disturbed by stray effects). 


One draw back is the need for high gain in the amplifier to 
compensate for feedback path losses. The oscillator am- 
plifies its own noise at start-up until it settles at the fre- 
quency that satisfies the gain/ohase requirements A x B = 
1, where A = V/V, is the gain of the amplifier and B = V/V, 
is the gain of the feedback element. The total phase shift 
around the loop is forced to zero (360 degrees). Since V,,, 
must be in phase with itself, the amplifier/inverter provides 
180 degree phase shift and the feedback element is forced 
to provide the other 180 degrees of phase shift. 
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R, is a resistive component placed from output to input of 
the amplifier. The purpose of this feedback is to bias the 
amplifier in its linear region and to provide the start-up 
transition. 


Capacitor C, combined with the amplifier output resis- 
tance provides a small phase shift. It will also provide some 
attenuation of overtones. 


Capacitor C, combined with the crystal resistance pro- 
vides additional phase shift. 


C, and C, can affect the start-up time if they increase 
dramatically in size. As C, and C, increase, the start-up 
time increases until the oscillator reaches a point where it 
does not start up any more. 


It is recommended for fast and reliable oscillator start-up 
(over the manufacturing process range) that the load 
Capacitors be sized as low as possible without resulting in 
overtone operation. 





Figure 3-5. Pierce Oscillator with Internal Feedback Circuit 
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3.4.1 Layout 


Traces connecting crystal, caps, and the Z8® oscillator 
pins should be as short and wide as possible. This 
reduces parasitic inductance and resistance. The compo- 
nents (caps, crystal, resistors) should be placed as close 
as possible to the oscillator pins of the Z8. 


The traces from the oscillator pins of the IC and the ground 
side of the lead caps should be guarded from all other 
traces (clock, V,, address/data lines, system ground) to 
reduce cross talk and noise injection. This is usually 
accomplished by keeping other traces and system ground 
trace planes away from the oscillator circuit and by placing 
a Z8 device V,, ground ring around the traces/compo- 
nents. The ground side of the oscillator lead caps should 
be connected to a single trace to the Z8 V,, (GND) pin. It 
should not be shared with any other system ground trace 
or components except at the Z8 device V,, pin. This is to 
prevent differential system ground noise injection into the 
oscillator (Figure 3-6). 


3.4.2 Indications of an Unreliable Design 


There are two major indicators that are used in working 
designs to determine their reliability over full lot and tem- 
perature variations. They are: 


Start-up Time. If start-up time is excessive, or varies widely 
from unit to unit, there is probably a gain problem. C,/C, 
needs to be reduced; the amplifier gain is not adequate at 
frequency, or crystal Rs is too large. 
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Output Level. The signal at the amplifier output should 
swing from ground to V_,. This indicates there is adequate 
gain in the amplifier. As the oscillator starts up, the signal 
amplitude grows until clipping occurs, at which point the 
loop gain is effectively reduced to unity and constant 
oscillation is achieved. A signal of less than 2.5 volts peak- 
to-peak is an indication that low gain may be a problem. 
Either C, or C, should be made smaller or a low-resistance 
crystal should be used. 


3.4.3 Circuit Board Design Rules 
The following circuit board design rules are suggested: 


m To prevent induced noise the crystal and load 
capacitors should be physically located as close to 
the Z8® as possible. 


@ Signallines should notrun parallel tothe clockoscillator 
inputs. In particular, the crystal input circuitry and the 
internal system clock output should be separated as 
much as possible. 


m V,., power lines should be separated from the clock 
oscillator input circuitry. 


m@ Resistivity between XTAL1 or XTAL2 and the other 
pins should be greater than 10 Mohms. 
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Signal Line 
Layout Should 

20 mm Avoid High 
Lighted Areas 





Clock Generator Circuit 


SignalsA B 


I 
(Parallel Traces 
Must Be Avoided) | , 
I 
i 





Board Design Example 
(Top View) 


Signal C 


=‘ (Connection to System Ground 
Must Be Avoided 


Figure 3-6. Circuit Board Design Rules 
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3.4.4 Crystals and Resonators 


Crystals and ceramic resonators (Figure 3-7) should have _—_!n most cases, the R, is O Ohms and R, is infinite. It is 
the following characteristics to ensure proper oscillator | determined and specified by the crystal/ceramic resona- 


operation: tor manufacturer. The R,, can be increased to decrease the 
amount of drive from the oscillator output to the crystal. It 
Crystal Cut AT (crystal only) can also be used as an adjustment to avoid clipping of the 
Mode Parallel, Fundamental Mode oscillator signal to reduce noise. The R, can be used to 
CrystalCapacitance <7 F improve the start-up of the crystal/ceramic resonator. The 
LoadCapacitance 10pF <CL< 220 pF, Z8 oscillator already has an internal shunt resistor in 
15 typical parallel to the crystal/ceramic resonator. 
Resistance 100 ohms max 


Depending on operation frequency, the oscillator may 
require the addition of capacitors C, and C, (shown in 
Figures 3-7). The capacitance values are dependenton the 
manufacturer’s crystal specifications. 


Vss 
XTAL2 


28 





Figure 3-9. External Clock 





Figure 3-7. Crystal/Ceramic Resonator Oscillator 





Figure 3-8. LC Clock 
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It is recommended in Figures 3-7, 3-8, and 3-9 to connect 
the load capacitor ground trace directly to the V,, (GND) 
pin of the Z8®. This ensures that no system noise is injected 
into the Z8 clock. This trace should not be shared with any 
other components except at the V,. pin of the 28. 


In some cases, the Z8 XTAL1 pin also functions as one of 
the EPROM high-voltage mode programming pins or as a 
special factory test pin. In this case, applying 2 V above 
Vog onthe XTAL1 pin will cause the device to enter one of 
these modes. Since this pin accepts high voltages to enter 
these respective modes, the standard input protection 
diode to V,, is not on XTAL1. It is recommended that in 
applications where the Z8 is exposed to much system 
noise, a diode from XTAL1 to V,, be used to prevent 
accidental enabling of these modes. This diode will not 
affect the crystal/ceramic resonator operation . 


Please note that a parallel resonant crystal or resonator 
data sheet will specify a load capacitor value that is the 
series combination of C, and C,, including all parasitics 
(PCB and holder). 
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3.5 LC OSCILLATOR. 


The Z8 oscillator can use a LC network to generate a XTAL 
clock (Figure 3-8). 


The frequency stays stable over V. and temperature. The 
oscillation frequency is determined by the equation: 


Frequency = 22(LCT)1/2 


where L is the total inductance including parasitics and 
C_ is the total series capacitance including the parasitics. 


Simple series capacitance is calculated using the following 
equation: 


j=.1+ 1 
GC. t. C. 
fC, =C, 
j= 2 
GL 
C, =2CT 


Sample calculation of capacitance C, and C, for 5.83 MHz 
frequency and inductance value of 27 uH: 


5.83 (1046) = 1 
On [2.7 (10) C_] 1/2 


CT = 27.6 pf 


Thus C, = 55.2 pf and C, = 55.2 pf. 
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3.6 RC OSCILLATOR 


In some cases, the Z8® has a RC oscillator option. Please 
refer to the specific product specification for availability. 
The RC oscillator requires a resistor across XTAL1 and 
XTAL2. An additional load capacitor is required from the 
XTAL1 input to V,, pin (Figure 3-9). 
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Figure 3-9. RC Clock 
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4.1 RESET 


This section describes the Z8® reset conditions, reset 
timing, and register initialization procedures. Reset is 
generated by Power-On Reset (POR), Reset Pin, Watch- 
Dog Timer (WDT), and Stop-Mode Recovery. 


Asystem reset overrides all other operating conditions and 
puts the Z8 into a known state. To initialize the chip’s 
internal logic, the /RESET input must be held Low for at 
least 4 internal system clock periods. The control register 
and ports are reset to their default conditions after a POR, 
a reset from the /Reset pin, or Watch-Dog Timer timeout 
while in RUN mode and HALT mode. The control registers 


4.2 /Reset Pin, Internal POR Operation 


In some cases, the Z8 hardware /RESET pin initializes the 
control and peripheral registers, as shown in Tables 4-1, 
4-2, 4-3, and 4-4. Specific reset values are shown by 1 or 
0, while bits whose states are unknown are indicated by the 
letter U. The Tables 4-1, 4-2, 4-3, and 4-4 show the reset 
conditions for the generic 28. 
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RESET—WATCH-DOG TIMER 


and ports are not reset to their default conditions after 
Stop- Mode Recovery and WDT timeout while in STOP 
mode. 


While /RESET is Low, /AS is output at the internal clock rate, 
/DS is forced Low, and R//W remains High. The program 
counter is loaded with OOOCH. I/O ports and control regis- 
ters are configured to their default reset state. 


Resetting the Z8 does not effect the contents of the 
general-purpose registers. 


Note: The register file reset state is device dependent. Please 
refer to the selected device product specifications for register 
availability and reset state. 
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Table 4-1. Sample Control and Peripheral Register Reset Values (ERF Bank 0) 








Register Register Bits 
(HEX) Name 76543210 Comments 
FO Serial 1/O UUUUUUUSU 
Ft Timer Mode 00000000 Counter/Timers Stopped 
F2 Counter/Timer1 UUUUUUUYU 
F3 T1 Prescaler UUUUUUOAO Single-Pass Count Mode, External Clock Source 
F4 Counter/TimerO U UUUUUUYU 
F5 TO Prescaler U UUUUUUO Single-Pass Count Mode 
F6 Port 2 Mode A eT A OE el All Inputs 
F7 Port 3 Mode 00000000 Port 2 Open-Drain, P33-P30 Input, P37-P34 Output 
F8 Port 0-1 Mode 01001101 Internal Stack, Normal Memory Timing 
F9 Interrupt Priority U UUUUUDJUYZU 
FA Interrupt Request 00000000 All Interrupts Cleared 
FB Interrupt Mask QOUUUUUUY Interrupts Disabled 
FC Flags UUUUUUDUYE 
FD Register Pointer 00000000 
FE Stack Pointer (High) U UUUUUUU 
FF Stack Pointer (Low) U UUUUUUU 


Program execution starts 5 to 10 clock cycles after /RESET 
has returned High. The initial instruction fetch is from 
location OOOCH. Figure 4-1 shows reset timing. 
First Machine Cycle 


Clock 
I 
SCLK 
Hold Low For 4 SCLK 
/RESET Periods (Minimum) 
/AS 
/DS 


vn a, 


ee First Instruction Fetch 


Figure 4-1. Reset Timing 





ie 
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After a reset, the first routine executed should be one that 
initializes the control registers to the required system 
configuration. 


The /RESET pin is the input of a Schmitt-triggered circuit. 
Resetting the Z8® will initialize port and control registers to 
their default states. To form the internal reset line, the 
output of the trigger is synchronized with the internal clock. 
The clock must therefore be running for 
/RESET to function. It requires 4 internal system clocks 
after reset is detected for the Z8 to reset the internal 
circuitry. An internal pull-up, combined with an external 
capacitor of 1 uf, provides enough time to properly reset 
the Z8 (Figure 4-2). In some cases, the Z8 has an internal 
POR timer circuit that holds the Z8 in reset mode for a 
duration (T,.,) before releasing the device out of reset. On 
these Z8 devices, the internally generated reset drives the 
reset pin low for the POR time. Any devices driving the 
reset line must be open-drained in order to avoid damage 
from possible conflict during reset conditions. This reset 
time allows the on-board clock oscillator to stabilize. 


To avoid asynchronous and noisy reset problems, the Z8 
is equipped with a reset filter of four external clocks 
(4TpC). If the external reset signal is less than 4TpC in 
duration, no reset occurs. On the fifth clock after the reset 
is detected, an internal RST signal is latched and held for 
an internal 
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/Reset 


Figure 4-2. Example of External Power-On Reset 
Circuit 


register count of 18 external clocks, or for the duration of 

the external reset, whichever is longer. During the reset 
cycle, /DS is held active low while /AS cycles ata rate of the 
internal system clock. Program execution begins at loca- 
tion OOOCH, 5-10 TpC cycles after /RESET is released. For 
the internal Power-On Reset, the reset output time is 
specified as T,.,. Please refer to specific product specifi- 
cations for actual values. 


Table 4-2. Sample Expanded Register File Bank 0 Reset Values 


Register Register Bits 
(HEX) Name 76543210 
00 Port 0 U UUUUUDJUYZU 
01 Port 1 U UUUUUUJUUZU 
02 Port 2 U UUUUUUU 
03 Port 3 1113100 UU 
04-EF  General- U UUUUUUYZU 

Purpose 

Registers 

04-EF 


Comments 

Input mode, output set to push-pull 
Input mode, output set to push-pull 
Input mode, output set to push-pull 
Standard Digital input and output 
Standard Digital input and output 
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Table 4-3. Sample Expanded Register File Bank C Reset Values 


Register Register Bits 
(HEX) Name 76543210 Comments 
00 SPI Compare 00000000 
(SCOMP) 
01 Receive Buffer UUUUUUUJUYZU 
(RxBUF) 
02 SPI Control U UUU0O000 
(SCON) 


Table 4-4. Sample Expanded Register File Bank F Reset Values 





Register Register Bits 
(HEX) Name 76543210 Comments 
00 Port Configuration 1. Se Se Comparator outputs disabled on Port 3 
(PCON) Port O and 1 output is push-pull 
Port O, 1, 2, 3, and oscillator with standard output 
drive 
OB STOP-Mode Recovery 0 0100000 Clock divide by 16 off 
(SMR) XTAL divide by 2 
POR and / OR External Reset 
Stop delay on 


Stop recovery level is low, STOP flag is POR 


OF Watch-Dog Timer 
Mode UUU0O1101 512 TC for WDT time out, WOT runs during STOP 
(WDTMR) and HALT mode, on-board RC drives WDT 
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/RESET: 4 eer or 
eee satay = 18 Clock RESET 
Generator RESET 
Internal 
RESET 
WOT Select PWT TAP SELECT | 


(WDTMR) 
CK Source 
Select 
(WDTMR) 
XTAL 256 ee 256 512 1024 4096 
POR TpC TpC TpC TpCc 


CK CLR  WODT/POR Counter Chain 






RC 
OSC. 
2.6V Operating 
VDD Voltage Det. 
2.6V REF. 
From Stop 
Mode 
Recovery 
Source 





12 ns Glitch Filter 


WDT 


Stop Delay 
Select (SMR) 


Figure 4-3. Example of Z8 Reset with /RESET Pin, WDT, SMR, and POR 
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4 Clock 


Clear 18 Clock RESET 
Filter 


yee WDT TAP SELECT 


CLK Source 
Select 
(WDTMR) or 


5ms POR 5Bms 15ms 25ms 100ms 


i> internal 
RESET 















XTAL 
CLK WDT/POR Counter Chain 
internal CLR 
RC 
OSC. 
2V Operating 
Voc Voltage Det. 
2V REF 
From Stop 
Mode 
Recovery 
Source — 42 ng Glitch Filter 
WDT 
Stop Delay 
Select (SMR) 


Figure 4-4. Example of Z8 Reset with WDT, SMR, and POR 
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4.3 Watch-Dog Timer (WDT) 


The WDT is a retriggerable one-shot timer that resets the 
Z8® if it reaches its terminal count. When operating in the 
RUN or HALT modes, a WDT reset is functionally equiva- 
lent to a hardware /POR reset. The WDT is initially enabled 
by executing the WDT instruction and refreshed on subse- 
quent executions of the WDT instruction. The WDT cannot 
be disabled after it has been initially enabled. Permanently 
enabled WDTs are always enabled and the WDT instruc- 
tion is used to refresh it. The WDT circuit is driven by an on- 
board RC oscillator or external oscillator from the XTAL1 
pin. The POR clock source is selected with bit 4 of the 
Watch-Dog Timer Mode register (WDTMR). Insome cases, 
a Z8 that offers the WDT but does not have a WOTMR 
register, has a fixed WDT timeout and uses the on board 
RC oscillator as the only clock source. Please refer to 
specific product specifications for selectability of timeout, 
WDT during HALT and STOP modes, source of WDT clock, 
and availability of the permanently-on WDT option. 


Note: Execution of the WDT instruction affects the Z (zero), S 
(sign), and V (overflow) flags. 


WDTMR_ (F) OF 


}p7| 06] os] oa] v3} 2} p+ bo) 


ie aa WDTTAPt INTRCOSC XTAL CLK 
00 5 512 Tpc 
01* 15° 1024 TpC 
10 25 2048 TpC 
11 100 8192 TpC 
WOT During HALT 
0 OFF 
1 ON * 
WDT During STOP 
0 OFF 
1 ON* 
XTAL1/INT RC Select for WOT 
0 On-Board RC * 
1 XTAL 


Reserved (Must be 0) 


* Default setting after RESET 
t Must be 01 for Z86C03 


Figure 4-5. Example of Z8 Watch-Dog Timer Mode 
Register (Write-Only) 


Note: The WDTMR register is accessible only during the first 64 
processor cycles from the execution of the first instruction after 
Power-On Reset, Watch-Dog Reset or a Stop-Mode Recovery. 
After this point, the register cannot be modified by any means, 
intentional or otherwise. The WDTMR is a write-only register. 
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The WDTMR is located in Expanded Register File Bank F, 
register OFH. The control bits are described as follows: 


WDT Time Select (D1, DO). Bits O and 1 control a tap 
circuit that determines the time-out period. Table 4-5 
shows the different values that can be obtained. The 
default value of D1 and DO are 0 and 1, respectively. 


Table 4-5. Time-Out Period of the WDT 





Typical 

Time-Out of Time-Out of 

D1 DO internal RC OSC XTAL Clock 

0 0 5 ms min 256T pC 

0 1 15 ms min 512TpC 

1 0 25 ms min 1024TpC 

1 1 100 ms min 4096TpC 
Notes: 


TpC = XTAL clock cycle 

The default on reset is, DO = 1 and D1 =0. 

The values given are for V.,. = 5.0V. 

See the device product specification for exact WOTMR time-out select 
options available. 


WDT During HALT (D2). This bit determines whether or 
not the WDT is active during HALT mode. A 1 indicates 
active during HALT. The defaultis 1. AWDT time out during 
HALT mode will reset control register ports to their default 
reset conditions. 


WODT During STOP (D3). This bit determines whether or 


not the WDT is active during STOP mode. Since XTAL 
clock is stopped during STOP Mode, unless as specified 
below, the on-board RC must be selected as the clock 
source to the POR counter. A 1 indicates active during 
STOP. The default is 1. If bits D3 and D4 are both set to 1, 
the WDT only, is driven by the external clock during STOP 
mode. This feature makes it possible to wake up from 
STOP mode from an internal source. Please refer to spe- 
cific product specifications for conditions of control and 
port registers when the Z8 comes out of STOP mode. A 
WDT time out during STOP mode will not reset all control 
registers. The reset conditions of the ports from STOP 
mode due to WDT time out is the same as if recovered 
using any of the other STOP mode sources. 
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Clock Source for WDT (D4). This bit determines which 
oscillator source is used to clock the internal POR and WDT 
counter chain. If the bit is a 1, the internal RC oscillator is 
bypassed and the POR and WDT clock source is driven 
from the external pin, XTAL1. The default configuration of 
this bit is 0, which selects the internal RC oscillator. 


Bits 5, 6 and 7. These bits are reserved. 
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V., Voltage Comparator. An on-board voltage compara- 
tor checks that V,,, is at the required level to insure correct 
operation of the device. Reset is globally driven if V.,. is 
below the specified voltage. This feature is available in 
select ROM Z8® devices. See the device product specifica- 
tion for feature availability and operating range. 





4.4 POWER-ON-RESET (POR) 


Atimer circuit clocked by a dedicated on-board RC oscilla- 
tor is used for the Power-On Reset (POR) timer (T,,,) 
function. The POR time allows V,,,. and the oscillator circuit 
to stabilize before instruction execution begins. 


The POR timer circuit is a one-shot timer triggered by one 
of three conditions: 


1. Power fail to Power OK status (cold start). 
2. STOP-Mode Recovery (if bit 5 of SMR=1). 
3. WDT timeout. 


The POR time is specified as T,,,. On Z8 devices that 
feature a Stop-Mode Recovery register (SMR), bit5 selects 
whether the POR timer is used after Stopo-Mode Recovery 
or by-passed. If bit D5 = 1 then the POR timer is used. If bit 
5 = 0 then the POR timer is by-passed. In this case, the 
Stop-Mode Recovery source must be held in the recovery 


_ State for 5 TC or 5 crystal clocks to pass the reset signal 


internally. This option is used when the clock is provided 
with an RC/LC clock. See the device product specification 
for timing details. 


POR (cold start) will always reset the Z8 control and port 
registers to their default condition. If a Z8 has a SMR 
register, the warm start bit will be reset to a O to indicate 
POR. 















INT OSC XTAL OSC 
POR 
(Cold Start) 
Delay Line 18 CLK Chip 
Tpor Ms Reset Filter Reset 





P27 
(Stop Mode) 





Figure 4-6. Example of Z8 with Simple SMR and POR 
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USER'S MANUAL 


CHAPTER 5 
I/O PORTS 





5.1 INTRODUCTION 


The Z8® has up to 32 lines dedicated to input and output. 
These lines are grouped into four 8-bit ports known as Port 
0, Port 1, Port 2, and Port 3. Port 0 is nibble programmable 
as input, output, or address. Port 1 is byte configurable as 
input, output, or address/data. Port 2 is bit programmable 
as either inputs or outputs, with or without handshake and 


5.1.1 Mode Registers 


Each port has an associated Mode Register that deter- 
mines the port’s functions and allows dynamic change in 
port functions during program execution. Port and Mode 
Registers are mapped into the Standard Register File as 
shown in Figure 5-1. 






Register HEX Identifier 
Port 0-1 Mode F8H PO1M 
Port 3 Mode F7H P3M 
Port 2 Mode F6H P2M 
03H P3 
02H P2 
01H P1 
OOH PO 


Figure 5-1. I/O Ports and Mode Registers 


Because of their close association, Port and Mode Regis- 
ters are treated like any other general-purpose register. 
There are no special instructions for port manipulation. Any 
instruction which addresses a register can address the 
ports. Data can be directly accessed in the Port Register, 
with no extra moves. 


SPI. Port 3 can be programmed to provide timing, serial 
and parallel input/output, or comparator input/output. 


All ports have push-pull CMOS outputs. In addition, the 
push-pull outputs of Port 2 can be turned off for open-drain 
operation. 


5.1.2 Input and Output Registers 


Each bit of Ports 0, 1, and 2, have an input register, an 
output register, associated buffer, and control logic. Since 
there are separate input and output registers associated 
with each port, writing to bits defined as inputs stores the 
data in the output register. This data cannot be read as long 
as the bits are defined as inputs. However, if the bits are 
reconfigured as outputs, the data stored in the output 
register is reflected on the output pins and can then be 
read. This mechanism allows the user to initialize the 
outputs prior to driving their loads (Figure 5-2). 


Since portinputs are asynchronous to the Z8 internal clock, 
a READ operation could occur during aninputtransition. In 
this case, the logic level might be uncertain (Somewhere 
between a logic 1 and 0). To eliminate this meta-stable 
condition, the Z8 latches the input data two clock periods 
prior to the execution of the current instruction. The input 
register uses these two clock periods to stabilize to a 
legitimate logic level before the instruction reads the data. 


Note: The following sections describe the generic function of the 


Z8 ports. Any additional features of the ports such as SPI, C/T, 
and Stop-Mode Recovery are covered in their own section. 
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5.2 Port 0 


This section deals with only the I/O operation ofPortO.The — in this manual. Figure 5-2 shows a block diagram of Port 
port's external memory interface operationiscoveredlater 0. This diagram also applies to Ports 1 and 2. 












Port I/O 
Lines 
Input 
Register 
Internal 
Timing 
8 
Handshake 

Selected Han dshake /DAV/RDY 
ogie RDY//DAV 







Output 
Register 





=a 











Output 
Enable 





Internal 
Bus 


Figure 5-2. Ports 0, 1, 2 Generic Block Diagram 
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5.2.1 General I/O Mode 


PortO can be an 8-bit, bidirectional, CMOS or TTL compat- 
ible I/O port. These eight I/O lines can be configured under 
software control as a nibble I/O port (PO3-P00 input/output 
and PQ7-P04 input/output), or as an address port for 
interfacing external memory. The input buffers can be 
Schmitt-triggered, level shifted, or a single-trip point buffer 
and can be nibble programmed. Either nibble output can 
be 


Open-Drain 


OEN 


oe 


Out 


1.5 ~<t@ 2.3V Hysteresis 
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globally programmed as push-pull or open-drain. Low EMI 
output buffers in some cases can be globally programmed 
by the software, as an OTP program option, or as a ROM 
mask option. In some, the Z8® has Auto Latches hardwired 
to the inputs. Please refer to specific product specifica- 
tions for exact input/output buffer type features that are 
available (Figures 5-3a and 5-3b). 


Port 0 


(/O or A15 - A8) 


Handshake Controls 
/DAVO and RDYO 
(P32 and P35) 


PAD 


Auto Latch 


Figure 5-3a. Port 0 Configuration with Open-Drain Capability, Auto Latch, and Schmitt-Trigger 
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OEN be. ® & 
D & 


PAD 


a >: 
OUT & 


TTL Level Shifter 


IN & 


Figure 5-3b. Port 0 Configuration with TTL Level Shifter 
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5.2.2 Read/Write Operations 


In the nibble I/O Mode, Port 0 is accessed as general- 
purpose register PO (OOH) with ERF Bank set to 0. The port 
is written by specifying PO as an instruction's destination 
register. Writing to the port causes data to be stored in the 
port's output register. 


The port is read by specifying PO as the source register of 
an instruction. When an output nibble is read, data on the 
external pins is returned. Under normal loading conditions 
this is equivalent to reading the output register. However, 
for Port 0 outputs defined as open-drain, the data returned 
is the value forced on the output by the external system. 
This may not be the same as the data in the output register. 
Reading a nibble defined as input also returns data on the 
external pins. However, input bits under handshake con- 
trol return data latched into the input register via the input 
strobe. 


The Port 0-1 Mode resister bits D,D, and D_D, are used to 
configure Port 0 nibbles. The lower nibble (PO,-PO,) can be 
defined as inputs by setting bits D, to 0 and D, to 1, or as 
outputs by setting both D, and D, to 0. Likewise, the upper 
nibble (PO,-P0_) can be defined as inputs by setting bits D, 
to 0 and D, to 1, or as outputs by setting both D, and D, to 
O (Figure 5-4). 


5.2.3 Handshake Operation 


When used as an |/0 port, Port O can be placed under 
handshake control by programming the Port3 Mode regis- 
ter bit D, to 1. In this configuration, handshake control lines 
are DAV, (P3,) and RDY, (P3,) when Port 0 is an input port, 
or RDY, (P3,) and DAV, (P3,) when Port 0 is an output port. 
(See Figure 5-5.) 


Handshake direction is determined by the configuration 
(input or output) assigned to the Port O upper nibble, PO,- 
PO,. The lower nibble must have the same |/0 configuration 
as the upper nibble to be under handshake control. Figure 
5-3a illustrates the Port O upper and lower nibbles and the 
associated handshake lines of Port 3. 
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5.3 Port 1 


This section deals onlywith the |/O operation. The port's external 
memory interface operation is discussed later in this manual. 
Figure 5-2 shows a block diagram of Port 1. 


5.3.1 General I/O Mode 


Port 1 can be an 8-bit, bidirectional, CMOS or TTL compat- 
ible port with multiplexed Address (A7-AQ) and Data (D7- 
DO) ports. These eight I/O lines can be byte programmed 
as inputs or outputs or can be configured under software 
control as an Address/Data port for interfacing to external 
memory. The input buffers can be Schmitt-triggered, level- 
shifted, or a single-point buffer. In some cases, the output 
buffers can be globally programmed as either push-pull or 
open-drain. Low-EMI output buffers can be globally pro- 
grammed by software, as an OTP program option, or as a 
ROM Mask Option. In some cases, the Z8® can have auto 
latches hardwired to the inputs. Please refer to specific 
product specifications for exact input/output buffer-type 
features available (Figures 5-6a and 5-6b). 


Register F8H 
Port 0-1 Mode Register (PO1M) 
(Write-Only) 


o7{oe}_ | | | jo1}po 


PO, - PO, MODE 
Our 


: PUT= 00 

L oheincon INPUT = 01 
INPUT = 01 Ag -Aq4 = 1X 
Ajo-~Ayg = 1X 


Figure 5-4. Port 0 /O Operation 


Register F7H 
Port 3 Mode Register (P3M) 


(Write-Only) 


tt tt pba] | 
0 P35 = INPUT | 


P3= = RDYO/DAVO 


Figure 5-5. Port 0 Handshake Operation 
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Port 1 
(I/O or AD7 - ADO) 


Handshake Controls 
/DAV1 and RDY1 
(P33 and P34) 





Open-Drain 


OEN >. > 
r e @ 


PAD 


Out ——at 


1.5 —— 2.3V Hysteresis 


i 


Figure 5-6a. Port 1 Configuration with Open-Drain Capability, Auto Latch, and Schmitt-Trigger 


OEN 


OUT 


Port 1 
(/O or AD7 - ADO) 


Handshake Controls 
/DAV1 and RDY1 
(P33 and P34) 





TTL Level Shifter 


i 


Figure 5-6b. Port 1 Configuration with TTL Level Shifter 
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5.3.2 Read/Write Operations 


In byte input or byte output mode, the port is accessed as 
General-Purpose Register P1 (01H). The port is written by 
specifying P1 as an instruction's destination register. Writ- 
ing to the port causes data to be stored in the port's output 
register. 


The port is read by specifying P1 as the source register of 
an instruction. When an output is read, data on the external 
pins is returned. Under normal loading conditions, this is 
equivalent to reading the output register. However, if 
Port 1 outputs are defined as open-drain, the data returned 
is the value forced on the output by the external system. 
This may not be the same as the data in the output register. 
When Port 1 is defined as an input, reading also returns 
data on the external pins. However, inputs under hand- 
shake control return data latched into the input register via 
the input strobe. 


Using the Port 0-1 Mode Register, Port 1 is configured as 
an output port by setting bits D, and D, to 0, or as an input 
portbysettingD, toOandD, to 1 (Figure5-8). 


R248 PO1M 
Port O-1 Mode Register 
(F8, Write-Only) 


_ | | tpsfost tT 
~ Lp - P13 Move 
3 


00% Byté Output 

Oi = Bite In ut 

10 = ADO - AD7 

eee a ADO - AD7, 
DS, R/W, A8 - A11, A12 - A15 


Figure 5-7. Port 1 I/O Operation 
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5.3.3 Handshake Operations 


When used as an |/O port, Port 1 can be placed under 
handshake control by programming the Port 3 Mode regis- 
ter bits D, and D, both to 1. inthis configuration, handshake 
control lines are DAV, (P3,) and RDY, (P3,) when Port 1 is 
an input port, or RDY, (P3,) and DAV, (P3,) when Port 1 is 
an output port. See Figures 5-6 and 5-8. 


Handshake direction is determined by the configuration 
(input and output) assigned to Port 1. For example, if Port 
1 is an output port then handshake is defined as output. 


R247 P3M 
Port 3 Mode Register 
(F7, Write-Only) 


“Wise 00 P33 = Input P34 = Output 
01 P33 = Input P34 =DM 


10 P33 = Input P34=DM —_ 
11 P33 = DAV1I/RDY1 P34 = RDY1/DAV1 


Figure 5-8. Handshake Operation 
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5.4 PORT 2 


Port 2 is a general-purpose port. Figure 5-2 shows a block 
diagram of Port 2. Each of its lines can be independently 
programmedas input or output via the Port 2 Mode Register 
(F6H) as seen in Figure 5-9. A bit set to a 1 in P2M 
configures the corresponding bitin Port2 as an input, while 
a bit set to 0 configures an output line. 


Register F6H 
Port2 Mode Register (P2M) 
(Write -Cn ly) 


D7] D6} 05 }o4} D3] ce fot} po 


a ee Port2 Mode 
0 = Output 
1= Input 


Figure 5-9. Port 2 I/O Mode Configuration 
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5.4.1 General Port I/O 


Port 2 can be an 8-bit, bidirectional, CMOS- or TTL- 
compatible I/O port. These eight I/O lines can be config- 
ured under software control to be an input or output, 
independently. Input buffers can be Schmitt-triggered, 
level-shifted, or a single trip point buffer and may contain 
Auto Latches. Bits programmed as outputs may be glo- 
bally programmed as either push-pull or open-drain. Low- 
EMI output buffers can be globally programmed by the 
software, an OTP program option, or as a ROM mask 
option. In addition, when the SPI is featured and enabled, 
P20 functions as data-in (Dl), and P27 functions as data- 
out (DO). Please refer to specific product specifications 
for exact input/output buffer type features available. See 
Figures 5-10a through 5-10c. 
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Open-Drain 


P21-P26 OE be. >} + BS ise 
| pao 


P21-P26 OUT ) > 


1.5» 2.3 Hysteresis @ Voc = 5.0V 


P21-P26 IN G 
5 
<g @ | Auto Latch 
e @ | 
| 
| 


Figure 5-10a. Port 2 Configuration with Open-Drain Capability, Auto Latch, and Schmitt-Trigger 


Open Drain 


OEN > | ¥ r) 


PAD 


OUT 
TTL Level Shifter 


IN 


Figure 5-10b. Port 2 Configuration with TTL Level Shifter 
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Open-Drain 


P20 OE ) > > i | 
SPI EN 3 P20 
Za PAD 





Auto Latch 


P20 IN 
or & 
_ ae 
Gi —O< | 


Open-Drain 


p27 our ———suancard > 
“ P27 
SPI DO lid a y 
a PAD 
P27 OE Standard 
SPI Active oh : _) > 


SCON 


[Ta] _] 9 P10 Enable 


1 P27 OUT 
P27 IN & 






*SPI must be enabled with DO. 
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L 


Figure 5-10c. Port 2 Configuration with Open-Drain Capability, Auto Latch, Schmitt-Trigger and SP! 
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5.4.2 Read/Write Operations 


Port 2 is accessed as General-Purpose Register P2 (02H). 
Port 2 is written by specifying P2 as an instruction’s 
destination register. Writing to Port 2 causes data to be 
stored in the output register of Port 2, and reflected 
externally on any bit configured as an output. Regardless 
of the bit input/output configuration, Port 2 is always written 
and read as a byte-wide port. 


Port 2 is read by specifying P2 as the source register of an 
instruction. When an output bit is read, data on the external 
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pin is returned. Under normal loading conditions, this is 
equivalent to reading the output register. However, if a bit 
of Port 2 is defined as an open-drain output, the data 
returned is the value forced on the output pin by the external 
system. This may not be the same as the data in the output 
register. Reading input bits of Port 2 also returns data on 
the external pins. However, inputs under handshake con- 
trol return data latched into the input register via the input 
strobe. 





5.4.3 Handshake Operation 


Port 2can be placed under handshake control by program- 
ming bit 6 in the Port 3 Mode Register (Figure 5-11). In this 
configuration, Port 3 lines P31 and P36 are used as the 
handshake control lines /DAV2 and RDY2 for input hand- 
shake, or RDY2 and /DAV2 for output handshake. 


Register F7H 
Port 3 Mode Register 
(Write-Only) 


p7 Jos|Ds}p4] pa|D2} 01} po 


Handshake direction is determined by the configuration 
(input or output) assigned to bit 7 of Port 2. Only those bits 
with the same configuration as P27 will be under hand- 
shake control. Figure 5-12 illustrates bit lines of Port 2 and 
the associated handshake lines of Port 3. 


~ LL port 2 Handshakin 


0 P31 = Input (T 
1 P31 = DAV? I 


P36 = Output 
(UNV bas = RD aA” 


Figure 5-11. Port 2 Handshake Configuration 


P29 


Port 2 (1/0) 


P27 


f Handshake Controls 


/DAV2 and RDY2 
(P31 and P36) 


Figure 5-12. Port 2 Handshaking 
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5.5 PORT3 
5.5.1 General Port I/O 


Port 3 differs structurally from Port 0, 1, and 2. Port 3 lines 
are fixed as four inputs (P33-P30) and four outputs (P37- 
P34) Port 3 does not have an input and output register for 
each bit. Instead, all the input lines have one input register, 
and all the output lines have an output register. Port 3 can 
be a CMOS- or TTL- compatible I/O port. Under software 
control, the lines can be configured as special control lines 
for handshake, comparator inputs, SPI control, external 
memory status, or I/O lines for the on-board serial and timer 
facilities. Figure 5-13 is a generic block diagram of Port 3. 
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The inputs can be Schmitt-triggered, level-shifted, or single- 
trip point buffered. In some cases, the Z8® may have auto 
latches hardwired on certain Port 3 inputs and Low-EMI 
capabilities on the outputs. Please refer to specific product 
specifications for exact input/output buffer type features. 
Please refer to the section on counter/timers, Stop-Mode 
Recovery, serial 1/O, comparators, and interrupts for more 
information on the relationships of Port 3 to that feature. 


Input Port 
Buffer 4 Input 
Lines 

P39-P33 


: , To Interrupt Timer, 
Handshake Logic 


or Serial I/O 








Output 
Register 


Pi 

Output utput 

Butter f——y’ Lines 
P3,4-P37 


Reale 
Internal anasnake LOGIC 
Bus or Serial I/O 


Figure 5-13. Port 3 Block Diagram 
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Port 3 


(I/O or Control) 





Se 








i ' Auto Latch 
r 
® e 
! i 
: R= 500KQ | 
30 Latch IRQ3 
R247 = P3M 
1 =Analog 
tT |= Digital 
DIG. 
P31 (AN1) ~ » IRQ2, Tix, P31 Data Latch 
AN. 
i 
1 
i 
Y 
P32 (AN2) rd ~~ » IRQO, P32 Data Latch 
>| 
i 
P33 (REF) : 
j 
From Stop-Mode , » 'RQ1, P33 Data Latch 


Recovery Source | . 


Figure 5-14a. Port 3 Configuration with Comparator, Auto Latch, and Schmitt-Trigger 
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P34 OUT 


P31 


REF (P33) 


P37 OUT 
P32 


REF (P33) 






om me ae eS ee pee OS ee ae Os oe oe 


0 P34, P37 Standard Output 
1 P34, P37 Comparator Output 


Figure 5-14b. Port 3 Configuration with Comparator 
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SK IN <j 


SPI EN 


SPI MSTR > =  } ay 
. Pils 


SPI EN 
SK OUT 
P34 OUT - 
P31 —p>- 
REF 


ss : < 
SPIEN 


SPI MSTR > Le P35 
P| 


P35 OUT <a. ; 
P32 —>- 5 


REF 





Do] 0 P34, P35 Standard Output 
1 P34, P35 Comparator Output 


Figure 5-14c. Port 3 Configuration with SPI and Comparator Outputs Using P34 and P35 
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PAD 
Out 


TTL Level Shifter Port 3 Output Configuration 


PAD 









Auto Latch 


ern aes os | 


R =500 KQ 


Port 3 Input Configuration 


Figure 5-14d. Port 3 Configuration with TTL Level Shifter and Auto Latch 
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5.5.2 Read/Write Operations 


Port 3 is accessed as a General-Purpose Register P3 
(03H). Port 3 is written by specifying P3 as an instruction’s 
destination register. However, Port 3 outputs cannot be 
written to if they are used for special functions. When 
writing to Port 3, data is stored in the output register. 


Port 3 is read by specifying P3 as the source register of an 
instruction. When reading from Port 3, the data returned is 
both the data on the input pins and in the output register. 


Register F7H 
Port 3 Mode Register 
EPeCeceec -Only) 


E 
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5.5.3 Special Functions 


Special functions for Port 3 are defined by programming the 
Port 3 Mode Register. By writing Os in bit 6 through 
bit 1, lines P37-P30 are configured as input/output pairs 
(Figure 5-15). Table 5-1 shows available functions for 
Port 3. The special functions indicated in the figure are 
discussed in detail in their corresponding sections in this 
manual. 


Port 3 input lines P33-P30 always function as interrupt 
requests regardless of the configuration specified in the 
Port 3 Mode Register. 


Port 2 Open-Drain 
Port 2 Push-Pull 


P31, P32 Digital Mode 
P31, P32 Analog Mode 


0 P3 nput park 

1 P32 = = /DAV/RDY2 P3s = = RD /IDAVO 
00 P33 = Input P34 = Output 
01 P33 = Input P34 = /DM 

10 P33 = Input P34 =/DM 

11 P33 =/DAV1/RDY1 P34 = RDY1//DAV1 
0 P31 = Input P36 = Output 

1 P32=/DAV2/RDY2 P36 = RDY2//DAV2 

0 P30 = Input P37 = Output 

1 P30=Serialin P37 = Serial Out 

0 Parity ON 

1 Parity OFF 


Figure 5-15. Port 3 Mode Register Configuration 
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Table 5-1. Port 3 Line Functions 


Function 


Inputs 


Outputs 


Port O Handshake Input 
Port 1 Handshake Input 
Port 2 Handshake Input 


Port O Handshake Output 
Port 1 Handshake Output 
Port 2 Handshake Output 


Analog Comparator Input 


Analog Comparator Output 


Interrupt Requests 


Serial Input 
Serial Output 


SPI Slave Select 
SPI Clock 


Counter/Timer 


External Memory Status 


Line 


P30 
P31 
P32 
P33 


P34 
P35 
P36 
P37 


P32 
P33 
P31 


P35 
P34 
P36 


P31 
P32 
P33 


P34 
P35 
P37 


P30 
P31 
P32 
P33 


P20 
P27 


P35 
P34 


P31 
P36 


P34 


Signal 


Input 
Input 
Input 
Input 


Output 
Output 
Output 
Output 


/DAVO/RDYO 
/DAV1/RDY1 
IDAV2/RDY2 


RDYO//DAVO 
RDY1//DAV1 
RDY2//DAV2 


AN1 
AN2 
REF 


AN1-OUT 
AN2-OUT 
AN2-OUT 


IRQ3 
IRQ2 
IRQO0 
IRQ1 


DI 
DO 


/DM 
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5.6 PORT HANDSHAKE 


When Ports 0, 1, and 2 are configured for handshake 
operation, a pair of lines from Port 3 are used for hand- 
shake controls. The handshake controls are interlocked to 
properly time asynchronous data transfers between the 
Z8® and a peripheral. One control line (/DAV) functions as 
a strobe from the sender to indicate to the receiver that 
data is available. The second control line (RDY) acknowl- 
edges receipt of the sender’s data, and indicates when the 
receiver is ready to accept another data transfer. 


In the input mode, data is latched into the Port’s input 
register by the first (DAV signal, and is protected from 
being overwritten if additional pulses occur on the /DAV 
line. This overwrite protection is maintained until the port 
data is read. In the output mode, data written to the portis 
not protected and can be overwritten by the Z8 during the 
handshake sequence. To avoid losing data, the software 
must not overwrite the port until the corresponding inter- 
rupt request indicates that the external device has latched 
the data. 


The software can always read Port 3 output and input 
handshake lines, but cannot write to the output handshake 
line. 


The following is the recommended setup sequence when 
configuring a Port for handshake operation for the first time 
after a reset: 


m Load PO1M or P2M to configure the port for input/ 
output. 

m Load P3 to set the Output Handshake bit 
to a logic 1. 

m LoadP3Mtoselectthe Handshake Mode for the port. 


Once a data transfer begins, the configuration of the 
handshake lines should not be changed until the hand- 
shake is completed. 


Figures 5-16 and 5-17 show detailed operation for the 
handshake sequence. 
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/DAV 
(Input To Z8) 


RDY 
(Output From Z8) 


Data On Port 
(Input To Z8) 


State 1. 
State 2. 


State 3. 


State 4. 
State 5. 
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= 


| 


val 


Port 3 Ready output is High, indicating that the Z8 is ready to accept data. 


The I/O device puts data on the port and then activates the /DAV input. This 
causes the data to be latched into the port input register and generates an 
interrupt request. 


The Z8 forces the Ready (RDY) output Low, signaling to the !/O device 
that the data has been latched. 


The I/O device returns the /DAV line High in response to the RDY going Low. 


The ze® software must respond to the interrupt request and read the contents 
of the port in order for the handshake sequence to be completed. The RDY line 
goes High if and only if the port has not been read and /DAV is High. This returns 
the interface to its initial state. 


Figure 5-16. Z8 Input Handshake 


RDY 
(Output From Z8) 


/DAV 
(Output From Z8) 


Data On Port 
(Output From Z8) 


State 1. 
State 2. 


State 3. 


State 4. 
State 5. 
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Valid Data 


-_« 

Nh 

ie) 
: A 


RDY input is High indicating that the I/O device is ready to accept data. 


The Z8® writes to the port register to initiate a data transfer. Writing the port 
outputs new data and forces /DAV Low if and only if RDY is High. 


The I/O device forces RDY Low after latching the data RDY Low causes an interrupt 
request to be generated. The Z8 can write new data in response to RDY going 
Low; however, the data is not output until State 5. 


The /DAV output from the Z8 is driven High in response to RDY going Low. 


The /DAV goes High, the I/O device is free to raise RDY High thus returning the 
interface to its initial state. 


Figure 5-17. Z8 Output Handshake 
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In applications requiring a strobed signal instead of the mm Inthe Strobed Output Mode, the RDY input should be 
interlocked handshake, the Z8® can satisfy this require- tied to the /DAV output. 


ment as follows: . 
Figures 5-18 and 5-19 illustrate the strobed handshake 


m Inthe Strobed Input mode, data canbe latchedinthe — connections. 
Port input register using the /DAV input. The data 
transfer rate must allow enough time for the software to 
read the Port before strobing in the next character. The 
RDY output is ignored. 


V/O 


Device 





Figure 5-18. Output Strobed Handshake on Port 2 





Figure 5-19. Input Strobed Handshake on Port 2 
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5.7 /O PORT RESET CONDITIONS 
5.7.1 Full Reset 


After a hardware reset, Watch-Dog Timer (WDT) reset, or a 
Power-On Reset (POR), Port Mode Registers PO1M, P2M, 
and P3M are set as shown in Figures 5-20 through 5-22. 
Port 2 is configured for input operation on all bits and is set 
for open-drain (Figure 5-22). If push-pull outputs are de- 
sired for Port 2 outputs, remember to configure them using 
P3M. Please note that a WDT time-out from Stop-Mode 
Recovery does not do a full reset. Certain registers that are 
not reset after Stop-Mode Recovery will not be reset. 


Register F8H 
Port 0-1 Mode Register (P01M) 
(Write-Only) 
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For the condition of the Ports after Stop-Mode Recovery, 
please refer to specific device product specifications. In 
some cases, the Z8® has the PO1M, P2M, and P3M control 
register set back to the default condition after reset while 
others do not. 


All special I/O functions of Port3 are inactive, with P33-P30 
set as inputs and P37-P34 set as outputs (Figure 5-22). 


Note: Because the types and amounts of I/O vary greatly among 
the Z8 family devices, the user is advised to review the selected 
device's product specifications for the register default state after 
reset. 


~ Co po0- po3 Mode 


00 = Output 
01 = Input 
1X = A8- Alt 


Stack Selection 
0 = External 
1 = Internal 


P10 - P17 Mode 

00 = Byte Output 

01 = Byte Input 

10 = AdO - Ad7 

11 = High Impedance ADO - AD7, A8 - A15, /AS, /DS, /R/W 


External Memory Timing 
Normal = 0 
Extended = 1 


P04 - P07 Mode 
Output = 00 


Input = 01 


Al2 -A15 = 1x 


Figure 5-20. Port 0/1 Reset 
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Register F6H 
Port 2 Mode Register (P2M) 
(Write-Only) 


ENED EN En EEE 


Z8® MICROCONTROLLERS 


CL Port 2 Mode 


0 = Output 
1 = Input 


Figure 5-21. Port 2 Reset 


Register F7H 
Port 3 Mode Register (P3M) 
(Write-Only) 


ee Oe 


Port 2 Open-Drain 


1 = Port 2 Push-Pull 


O= 


P31, P32 Digital Mode 


1 = P31, P32 Analog Mode 


O= 


P32 = Input P35 = Output 


1 = P32 = /DAV 


00 
01 
10 
11 


-_- © 


“=O —~o 


P33 = Input 
P33 = Input P34=/DM 
P33 =Input P34=/DM 
P33 =/DAV1/RDY1 P34 = RDY1//DAV1 


P34 = Output 


P31 = Input P36 = Output 
P31 =/DAV2/RDY2 P36 = RDY2//DAV2 


P30 = Input P37 = Output 
P30 = Serial ln P37 = Serial Out 


Parity Off 
Parity On 


Figure 5-22. Port 3 Mode Reset 
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5.8 ANALOG COMPARATORS 


Select Z8® devices include two independent on-chip ana- 
log comparators. See the device product specification for 
feature availability and use. Port 3, Pins P31 and P32 each 
have a comparator front end. The comparator reference 
voltage, pin P33, is common to both comparators. In 
Analog Mode, the P31 and P82 are the positive inputs to 
the comparators and P33 is the reference voltage supplied 
to both comparators. In Digital Mode, pin P33 can be used 
as a P33 register input or IRQ1 source. P34, P35, or P37 
may output the comparator outputs by software-program- 
ming the PCON Register bit DO to 1. 


Register F7H 
Port 3 Mode Register (PSM) 
(Write-Only) 


EY ed 
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5.8.1 Comparator Description 


Two on-board comparators can process analog signals on 
P31 and P82 with reference to the voltage on P33. The 
analog function is enabled by programming the Port 3 
Mode Register (P3M bit 1). For interrupt functions during 
analog mode, P31 and P32 can be programmable as 
rising, falling, or both edge triggered interrupts (IRQ reg- 
ister bits 6 and bit 7). 


Note: P33 cannot generate an external interrupt while in this 
mode. P33 can only generate interrupts in the Digital Mode. 


Note: Port 3 inputs must be in digital mode if Port 3 is a Stop- 
Mode Recovery source. The analog comparator is disabled in 
STOP mode. 


P31 can be used as T,, in Analog or Digital Modes, but it 
must be referenced to P33, when in Analog Mode. 


~L__._ 0 = Digital Mode P31, P32, P33 


1 = Analog Mode P31, P32, P33 


Figure 5-23. Port 3 Input Analog Selection 


ERF Bank F 
Register OOH 


Port Configuration Register (PCON) 


(Write-Only) 


= 0 P34, P35, or P37 Standard Outputs 


1 P34, P35, or P37 Comparator Outputs 


Figure 5-24. Port 3 Comparator Output Selection 
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Port 3 
(I/O or Control) 


Auto Latch 





P30 Data 
P30 Latch IRQS 
R247 = P3M 
1 =Analog 
0 = Data 
DIG. 
P31 (AN1) ~ » IRQ2, Ti, P31 Data Latch 
- 
AN. I 
I 
I 
1 
y 
P32 (AN2) 7 _ » IRQO, P32 Data Latch 
3 » | 
i 
P33 (REF) ' 
j 
From Stop-Mode 5 IRQ1, P33 Data Latch 
Recovery Source 


Figure 5-25. Port Configuration of Comparator Inputs on P31, P32, and P33 
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P34 OUT 

P31 PAD 

4 

REF (P33) ! 

| 

I 

I 

t 

I 

I 

I 

i 

P37 OUT ; 
P32 PAD 


REF (P33) 






0 P34, P37 Standard Output 
1 P34, P37 Comparator Output 


Figure 5-26. Port 3 Configuration 


5.8.2 Comparator Programming 


Example of enabling analog comparator mode. 
LD P3M, #XXXX XX1XB 


Note: X= don'tcare. 


Example of enabling analog comparator output. 


LD RP, #%0FH Sets register pointer to 
;working register group 0 
;and Expanded Register 
‘File bank. 


LD RO, #XXXX XXX1B_ ;Enables comparator 


‘outputs using PCOM 
;Register programming. 
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5.8.3 COMPARATOR OPERATION 


After enabling the Analog Comparator mode, P33 be- 
comes a common reference input for both comparators. 
The P33 (Ref) is hard wired to the reference inputs to both 
comparators and cannot be separated. P31 and P32 are 
always connected to the positive inputs to the comparators. 
P31 is the positive input to comparator AN1 while P32 is the 
positive input to comparator AN2. The outputs to compara- 
tors AN1 and AN2 are AN1-out and AN2-out, respectively. 


The comparator output reflects the relationship between 
the positive input to the reference input. 


Example: If the voltage on AN1 is higher than the voltage 
on Ref then AN1-outwill be at ahigh state. If voltage on AN2 
is lower than the voltage on Ref then AN2-out will be at a 
Low state. In this example, when the Port 3 register is read, 
Bits D1 = 1 and D2 = 0. If the comparator outputs are 
enabled to come out on P34 and P37, then P34 = 1 and P37 
= Q. Please note that the previous data stored in P34 and 
P37 isnot disturbed. Once the comparator outputs are de- 
selected the stored values in the P34 and P37 register bits 
will be reflected on these pins again. 


5.8.4 Interrupts 


In the example from Section 5.8.3, P32 (AN2) will generate 
an interrupt based on the result of the comparison being low 
and the Interrupt Request Register (IRQ FAH) having bits 
D7=0 and D6=0. If IRQD7=1 and D6=0 then both P31 and 
P32 would generate interrupts. 


5.8.5. Comparator Definitions 
5.8.5.1. Vig 


The usable voltage range for both positive inputs and the 
reference input is called the common mode voltage range 
(Vion). The comparator is not guaranteed to work if the 
inputs are outside of the V,., range. 


5.8.5.2. V 


OFFSET 


The absolute value of the voltage between the positive 
input and the reference input required to make the com- 
parator output voltage switch is the input offset voltage 
(Voffset). If AN1 is 3.000V and Ref is 3.001V when the 
comparator output switches states then the Voffset = 1mV. 


5.8.5.3. |, 


For CMOS voltage comparator inputs, the input offset 
current (1,,) is the leakage current of the CMOS input gate. 
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5.8.6. RUN Mode 


P33 is not available as an interrupt input during Analog 
Mode. P31 and P82 are valid interrupt inputs in conjunc- 
tion with P33 (Ref) when in the Analog Mode. 


P31 can still be used as T,, when the analog mode is 
selected. If comparator outputs are desired to be outputted 
on the Port 3 outputs, please refer to specific products 
specification for priority of muxing when other special 
features are sharing those same Port 3 pins. 


5.8.7. HALT Mode 


The analog comparators are functional during HALT Mode 
if the Analog Mode has been enabled. P31 and P32, in 
conjunction with P33 (Ref) will be able to generate inter- 
rupts. Only P33 cannot generate an interrupt since the P33 
input goes directly to the Ref input of the comparators and 
is disconnected from the interrupt sensing circuits. 


5.8.8. STOP Mode 


The analog comparators are disabled during STOP Mode 
so it does not use any current at that time. If P31, P32, or 
P33 are used asa source for Stop-Mode Recovery, the Port 
3 Digital Mode must be selected by setting bit D1=0 in the 
Port 3 Mode Register. Otherwise in STOP Mode, the P31, 
P32, and P33 cannot be sensed. If the Analog Mode was 
selected when entering STOP Mode, it will still be enabled 
after a valid SMR triggered reset. 
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5.9 OPEN-DRAIN CONFIGURATION 


All Z8s can configure Port 2 to provide open-drain outputs 
by programming the Port 3 Mode Register (P3M) bit DO=0. 


Register F7H 
Port 3 Mode Register 
(Write Only) 


[p7] be} 0s] 04] 03} oa} 01 Joo 


“CH Port 2 Configuration 


0= Pull-Ups Open-Drain 
1 = Pull-Ups Active 


Figure 5-27. Port 2 Configuration 


Other Z8s that have a Port Configuration Register (PCON) 
that can configure Port 0 and Port 1 to provide open-drain 
outputs. The PCON Register is located in Expanded 
Register File (ERF) Bank F, Register OOH. See Figure 5-28. 


PCON (FH) 00H 


ez [Pe bs peepee | beet ae 


L_ Comparator Output Port 3 
0 P34, P37 Standard Output* 
1 P34, P37 Comparator Output 
0 Port 1 Open Drain 


1 Port 1 Push-pull Active* 


0 PortO Open Drain 
1 Port 0 Push-pull Active* 


0 PortO Low EMI 
1 PortO Standard* 


0 Port 1 Low EMI 
1 Port 1 Standard* 


0 Port2 Low EMI 
1 Port 2 Standard* 


0 Port3 Low EMI 
1 Port3 Standard’ 


Low EMI Oscillator 


0 Low EM 


* Default SettingAfter Reset 1 Standard* 


Figure 5-28. Port Configuration Register (PCON) 
(Write-Only) 


Port 1 Open-Drain(D1).Port 1 canbeconfiguredasopen-drainby 
resettingthis bit(D1=0)orconfiguredas push-pullactivebysetting this 
bit(D1=1). Thedefaultvalueis 1. 


Port O Open Drain (D2). Port 0 can be configured as open- 
drain by resetting this bit(D2=0) or configured as push-pull 
active by setting this bit (D2=1). The default value is 1. 


5.10 LOW EMI EMISSION 


Some Z8s can be programmed to operate in a Low EMI 
Emission Mode using the Port configuration register 
(PCON). The PCON register allows the oscillator and all I/ 
O ports to be programmed in the Low-EMI Mode indepen- 
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dently. Other Z8s may offer a ROM Mask or OTP program- 
ming option to configure the Z8 Ports and oscillator glo- 
bally to a Low-EMI mode (where the XTAL frequency is set 
equal to the internal system clock frequency. 


Use of the Low EMI feature results in: 


m The output pre-drivers slew rate reduced to 10 ns 
(typical). 

m Low EMI output drivers have resistance of 200 Ohms 
(typical). 

m Low EMI Oscillator. 

m@ All output drivers are approximately 25 percent of the 
standard drive. 

m Internal SCLK/TCLK = XTAL operation limited to a 
maximum of 4 MHz - 250 ns cycle time, when Low EMI 
Oscillator is selected and system clock (SCLK=XTAL, 
SMR Reg. Bit D1=1). 


For Z8s having the PCON register feature, the following bits 
control the Low EMI options: 


m@ =Low EMI Port 0 (D3). Port 0 can be configured as a 
Low EMI Port by resetting this bit (D3=0) or configured 
as a Standard Port by setting this bit (D3=1). The 
default value is 1. 


m Low EMI Port 1 (D4). Port 1 can be configured as a 
Low EMI Port by resetting this bit (D4=0) or configured 
as a Standard Port by setting this bit (D4=1). The 
default value is 1. 


m@ Low EMI Port 2 (D5). Port 2 can be configured asa 
Low EMI Port by resetting this bit (D5=0) or configured 
as a Standard Port by setting this bit (D5=1). The 
default value is 1. 


m@ Low EMI Port 3 (D6). Port 3 can be configured as a 
Low EMI Port by resetting this bit (D6=0) or configured 
as a Standard Port by setting this bit (D6=1). The 
default value is 1. 


m@ Low EMI OSC (D7). This bit of the PCON Register 
controls the Low EMI oscillator. A 1 in this location 
configures the oscillator with standard drive, while a 0 
configures the oscillator with low noise drive. The Low- 
EMI mode will reduce the drive of the oscillator (OSC). 
The default value is 1. XTAL/2 mode is not effected by 
this bit. 


Note: The maximum external clock frequency is 4 MHz when 
running in the Low EMI oscillator mode. 


Please refer to the selected device product specification 
for availability of the Low EMI feature and programming 
options. 
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5.11 INPUT PROTECTION 





All CMOS ROM Z8s have I/O pins with diode input protec- On CMOS OTP EPROM Z8’s, the Port 3 inputs P31, P32, 
tion. There is a diode from the I/O padtoV,,andtoV,,. See | P33 and the XTAL 1 pin have only the input protection 
Figure 5-29A. diode from pad to V,,. See Figure 5-29B. 


Voc 
‘ Vss 
Figure 5-29b. OTP Diode Input Protection 


Vos The high-side input protection diodes were removed on 

these pins to allow the application of +12.5V during the 

Figure 5-29a. Diode Input Protection various OTP programming modes. 
For better noise immunity in applications that are exposed 
to system EMi, a clamping diode to V,,, from these pins 
may be required to prevent entering the OTP programming 
mode or to prevent high voltage from damaging these 
pins. 
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5.12. CMOS Z8 AUTO LATCHES 


I/O port bits that are configurable as inputs are protected 
against open circuit conditions using Auto Latches. An 
Auto Latch is a circuit which, in the event of an open circuit 
condition, latches the input at a valid CMOS level. This 


Vpp 


Pad H 


Vop 


Auto Latch 
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inhibits the tendency of the input transistors to self-bias in 
the forward active region, thus drawing excessive supply 
current. A simplified schematic of the CMOS Z8 1/O circuit 
is shown in Figure 5-30. 


Open-Drain 


OE 


Data Out 


Data In 


G1 


Figure 5-30. Simplified CMOS Z8 I/O Circuit 


The operation of the Auto Latch circuit is straight-forward. 
Assume the input pad is latched at +5V (logic 1). The 
inverter G1 inverts the bit, turning the P-channel FET ON 
and the N-channel FET OFF. The output of the circuit is 
effectively shorted to V,,,,, returning +5V to the input. If the 
pad is then disconnected from the +5V source, the Auto 
Latch will hold the input at the previous state. If the device 
is powered up with the input floating, the state of the Auto 
Latch will be at either supply, but which state is unpredict- 
able. 


There are four operating conditions which will activate the 
Auto Latches. The first, which occurs when the input pin is 
physically disconnected from any source, is the most 
obvious. The second occurs when the input is connected 
to the output of a device with tri-state capability. 


The Auto Latch will also activate when the input voltage at 
the pin is not within 200 microV or so of either supply rail. 
In this case, the circuit will draw current, which is not 
significant compared to the Icc operating current of the 
device, but will increase |,,, STOP Mode current of the 
device dramatically. 


The fourth condition occurs when the 1/O bit is configured 
as an output. Referring to the output section of Figure 5-30, 
there are two ways of tri-stating the port pin. The first is by 
configuring the port as an input, which disables the /OE 
Signal turning both transistors off. The second can be 
achieved in output mode by writing a “1” to the output port, 
then activating the open drain mode. Both transistors are 
again off, and the port bit is ina high impedance state. The 
Auto Latches then pull the input section toward V,,,. 
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Auto Latch Model: 


The Auto Latch’s equivalent circuit is shown in Figure 5-31. 
When the input is high, the circuit consists of a resistance 
Rp from V,,, (the P-channel transistor in its ON state) and 
a much greater resistance Rh to GND. Current lao flows 
from V_, to the output. When the input is low, the circuit 
may be modeled as a resistance Rp from GND (the N- 
channel transistor in the ON state) and a much greater 


VpD 


‘i 






Rp 
Data In 
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resistance Rh to V,,,. Current lao now flows from the input 
to ground. The Auto Latch is characterized with respect to 
lao, so the equivalent resistance Rp is calculated accord- 
ing to RP= (V,,-V,,)/lao. The worst case equivalent resis- 
tance Rp (min) may be calculated at the worst case input 
voltage, Vi= Vih(min). 


VppD 






Ry 
Data In 


Logic 0 


Figure 5-31. Auto Latch Equivalent Circuit 
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Design Considerations: 


For circuits in which the Auto Latch is active, consideration 
should be given to the loading constraints of the Auto 
Latches. For example, with weak values of V,,,, close to Vih 
(min) or Vil (max), pullup or pull-down resistances must be 
calculated using Ref = R/Rp. For best case STOP mode 
operation, the inputs should be within 200 mV of the supply 
rails. 


In output mode, if a port bit is forced into a tri-state 
condition, the Auto Latches will force the pad to V,,. If 
there is an external pulldown resistor on the pin, the voltage 
at the pin may not switch to GND due to the Auto Latch. As 
shown in Figure 5-32, the equivalent resistance of the Auto 
Latch and the external pulldown form a voltage divider, 
and if the 


HMA 


i 5 
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external resistor is large, the voltage developed across it 
will exceed Vil(max). For worst case: 


Vil(max > V,, [Rext/(Rext+Rp)] 
Rext(max) = [(Vil(max)/V,,)Rp]/[1-(Vil(max)/V,,,)] 


For V., = 5.0V and lao = 5 uA we have Vih(max) =0.8V: 
Rext(max) = (0.16/1M)/(1-0.16) = 190 K ohms. 


Rp increases rapidly with V 
the requirement on Rext. 


pp 80 increased V,,, will relax 


In summary, the CMOS Z8 Auto Latch inhibits excessive 
current drain in Z8 devices by latching an open input to 
either V,, or GND. The effect of the Auto Latch on the I/O 
characteristics of the device may be modeled by acurrent 
lao and a resistor Rp, whose value is V,,/lao. 


Pp 
Vin (min.) 


REXT 


Figure 5-32. Effect of Pulldown Resistors on Auto Latches 
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CHAPTER 6 
COUNTER/TIMERS 





6.1 INTRODUCTION 


The Z8® provides up to two 8-bit counter/timers, TO andT1, 
each driven by its own 6-bit prescaler, PREO and PRE1 
(Figure 6-1). Both counter/timers are independent of the 
processor instruction sequence, that relieves software 
from time-critical operations such as interval timing or 
event counting. Some MCUs offer clock scaling using the 
SMR register. See the device product specification for 
clock available options. The following description is typi- 
cal. 





















Each counter/timer operates in either Single-Pass or Con- 
tinuous mode. Atthe end-of-count, counting either stops or 
the initial value is reloaded and counting continues. Under 
software control, new values are loaded immediately or 
when the end-of-count is reached. Software also controls 
the counting mode, how a counter/timer is started or 
stopped, and its use of 1/0 lines. Both the counter and 
prescaler registers can be altered while the counter/timer is 
running. 



















OSC 
D1 (SMR) Internal Data Bus 
Write f 
+2 
PREO TO TO 
Initial Value Initial Value § Current Value 
Register Register Register 
DO (SMR) || 
+16 6-Bit 8-bit __j 
Down Down 
| Counter Counter IRQ4 
Internal 
Clock 
External Clock P36 
Clock 
Logic 8-Bit 
; IRQ5 
‘ Counter Counter 
Internal Clock i 
Gated Clock PRE1 T1 T1 | 
Triggered Clock initial Value Initial Value Current Value 
Register Register Register 
Tin, P31 
IN Write | 








internal Data Bus 


Figure 6-1. Counter/Timer Block Diagram 
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Counter/timers 0 and 1 are driven by a timer clock gener- 
ated by dividing the internal clock by four. The divide-by- 
four stage, the 6-bit prescaler, and the 8-bit counter/timer 
form a synchronous 16-bit divide chain. Counter/timer 1 
can also be driven by a external input (T,,.) using P31. Port 
3 line P36 can serve as a timer output (T,,,) through which 
TO, T1, or the internal clock can be output. The timer output 
will toggle at the end-of-count. 


The counter/timer, prescaler, and associated mode regis- 
ters are mapped into the register file as shown in Figure 
6-2. This allows the software to treat the counter/timers as 
general-purpose registers, and eliminates the need for 
special instructions. | 


6.2 PRESCALERS AND COUNTER/TIMERS 


The prescalers, PREO (F5H) and PRE1 (F3H), each con- 
sist of an 8-bit register and a 6-bit down-counter as shown 
in Figure 6-1. The prescaler registers are write-only regis- 
ters. Reading the prescalers returns the value FFH. Figures 
6-3 and 6-4 show the prescaler registers. 


The six most significant bits (D2-D7) of PREO or PRE1 hold 
the prescalers count modulo, a value from 1 to 64 decimal. 
The prescaler registers also contain control bits thatspecify 
TOandT1 counting modes. These bits also indicate whether 
the clocksource for T1 is internal or external. These control 
bits will be discussed in detail throughout this chapter. 


The counter/timer registers, TO (F4H) and T1 (F2H), each 
consist of an 8-bit down-counter, a write-only register that 
holds the initial count value, and a read-only register that 
holds the current count value (Figure 6-1). The initial value 
can range from 1 to 256 decimal (01H,02H,..,00H). Figure 
6-5 illustrates the counter/timer registers. 


DEC HEX Identifiers 


247 Port 3 Mode F7 


245 To Prescaler F5 


244 Timer/Counter0 F4 


243 T1 Prescaler F3 
242 Timer/Countert F2 


241 Timer Mode F1 





Figure 6-2. Counter/Timer Register Map 
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R245 PREO 
Prescaler 0 Register 
(%F5; Write -Only) 


D7 PDg fP5 {4 [Pg JPo JP, [Do | 
oe Count Mode 
O=T 


=T,, Single Pass 
5 7? Modulo-n 


Reserved (Must be 0) 
Prescaler Modulo 


(Range: 1-64 Decimal 
01-00 HEX) 


Figure 6-3. Prescaler 0 Register 


Register F8H 
Port 0-1 Mode Register (PO1M) 
(Write-Only) 


D7[pe}|_ | | | {b1}po| 
PO, - PO. MODE 
+ PO 0 Pema ate OUTPUT= 00 


INPUT = 01 gs so 


Figure 6-4. Prescaler 1 Register 


R242 T1 
Counter/Timer 1 Register 
(%F2; Read/Write Only) 


R244 T0 


Counter/Timer 0 Register 
(%F4; Read/Write Only) 


Dg Ps [4 Js [Po Js [Po | 
| Initial value when written 


(Range 1-256 decimal, 01-00 HEX) 
current value when read 


Figure 6-5. Counter / Timer 0 and 1 Registers 
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6.3 COUNTER/TIMER OPERATION 


Under software control, counter/timers are started and 
stopped via the Timer Mode Register (TMR,F1H) bits D,-D, 
(Figure 6-6). Each counter/timer is associated with a Load 
bit and an Enable Count bit. 


6.3.1 Load and Enable Count Bits 


Setting the Load bit (D, for TO and D, for T1) transfers the 
initial value in the prescaler and the counter/timer registers 
into their respective down-counters. The next internal clock 
resets bits D, and D, to0, readying the Load bit for the next 
load operation. New values may be loaded into the down- 
counters at any time. If the counter/timer is running, it 
continues to do so and starts the count over with the new 
value. Therefore, the Load bit actually functions as a 
software re-trigger. 


R241 TMR 
Timer Mode Register 
(% F1; Read/Write) 


TL 0 = No Function 
1 = Load To 
0 = Disable To Count 
1 = Enable Tp Count 
0 = No Function 
1 = Load Ty 
0 = Disable T, Count 
1 = Enable T; Count 


Figure 6-6. Timer Mode Register 


M3 M1 





M2 Mn 
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The counter timers remain at rest as long as the Enable 
Count bits are 0. To enable counting, the Enable Count bit 
(D, for TO and D, for T1) must be set to 1. Counting actually 
starts when the Enable Count bit is written by an instruc- 
tion. The first decrement occurs four internal clock periods 
after the Enable Count bit has been set. If T1 is configured 
to use an external clock, the first decrement begins on the 
next clock period. The Load and Enable Count bits can be 
set at the same time. For example, using the instruction: 


OR TMR,#03H 


sets both DO and D1 of the TMR. This loads the initial values 
of PREO and TO into their respective counters and starts the 
count after the M2T2 machine state after the operand is 
fetched (Figure 6-7). 


R243 PRE1 
Prescaler 1 Register 
(%F3; Write-Only) 


R245 PREO 


Prescater 0 Register 
(%F5; Write-Only) 


| | | | | {| f {| 
“LL Count Mode 
O=T, sl Pass 
1 =T, M 


ulo-n 


Figure 6-7. Starting The Count 





ee First Decrement Occurs 
Four Clock Periods Later 


TMR is Written, Counter/Timer 
is Loaded 


#03H is Fetched 


Figure 6-8. Counting Modes 
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6.3.2 Prescaler Operations 


During counting, the programmed clock source drives the 
6-bit Prescaler Counter. The counter is counted down from 
the value specified by bits of the corresponding Prescaler 
Register, PREO (bit 7 to bit 2) or PRE1 (bit 7 to bit 2). 
(Figures 6-3, 6-4). When the Prescaler Counter reaches its 
end-of-count, the initial value is reloaded and counting 
continues. The prescaler never actually reaches O. For 
example, if the prescaler is set to divide-by-three, the 
count sequence is: 


3-2-1-3-2-1-3-2-1-3... 


Each time the prescaler reaches its end of count a carry is 
generated, that allows the Counter/Timer to decrement by 
one on the next timer clock input. When the Counter/Timer 
and the prescaler both reach the end-of-count, an interrupt 
request is generated (IRQ4 for TO, IRQ5 for T1). Depend- 
ing on the counting mode selected, the Counter/Timer will 
either come to rest with its value at OOH (Single-Pass Mode) 
or the initial value will be automatically reloaded and 
counting will continue (Continuous Mode). The counting 
modes are controlled by bit O of PREO and bit 0 of PRE1. 
(Figure 6-8). AO, written to this bit configures the counter 
for Single-pass counting mode, while a 1 written to this bit 
configures the counter for Continuous mode. 


The Counter/Timer can be stopped at any time by setting 
the Enable Count bit to 0, and restarted by setting it back 
to 1. The Counter/Timer will continue its count value at the 
time itwas stopped. The current value in the Counter/Timer 
can be read at any time without affecting the counting 
operation. 


Note: The prescaler registers are write-only and cannot be read. 


New initial values can be written to the prescaler or the 
Counter/Timer registers at any time. These values will be 
transferred to their respective down counters on the next 
load operation. If the Counter/Timer mode is Continuous, 
the next load occurs on the timer clock following an end- 
of-count. New initial values should be written before the 
desired load operation, since the prescalers always effec- 
tively operate in Continuous count mode. 
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The time interval (i) until end-of-count, is given by the 
equation: 


i=tXpXv 
in which: 


t = four divided by the internal clock frequency. 


The internal clock frequency defaults to the external clock 
source (XTAL, ceramic resonator, and others) divided by 
2. Some Z8® microcontrollers allow this divisor to be 
changed via the Stop-Mode Recovery register. See the 
product data sheet for available clock divisor options. 


Note that t is equal to eight divided-by-XTAL frequency of 
the external clock source for T1 (external clock mode only). 


p = the prescaler value (1 - 63) for T, and T,. 
The minimum prescaler count of 1 is achieved by loading 
000001xx. The maximum prescaler count of 63 is achieved 
by loading 11111 1xx. 

v=theCounter/Timervalue (1-256) 
Minimum duration is achieved by loading 01H (1 prescaler 
output count), maximum duration is achieved by loading 


OOH (256 prescaler outputs counts). 


It should be apparent the prescaler and counter/timer are 
true divide-by-n counters. 
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6.4 T,,,, Modes 


The Timer Mode Register TMR (F1H ) (Figure 6-9), isused = 11. Inorder for T,,, to function, P36 must be defined as an 
in conjunction with the Port 3 Mode Register P3M (F7H) _ outputline by setting P3M bit 5 to 0. Output is controlled by 
(Figure 6-10) to configure P36 for T,,,,operationforTOand — one of the counter/timers (TO or T1 ) or the internal clock. 


Register FiH 7 
Timer Mode Register (TMR) 
(Read/Write) 


o7}oey fost do 


= 0 = No Function 
1 = Load TO 
0 = Disable T1 Count 
1 = Enable T1 Count 


T, Modes 
oo Lt 


oT Ut 


10 =T1 Out 
11 = Internal Clock Out 


Figure 6-9. Timer Mode Register (T.,. Operation) 


OUT 


Register F7H 
Port 3 Mode Register (P3M) 
(Write-Only) 


tT pst tT 
O P381=! P36 =O 
eee 31 = Input Ny, 36 = Output A lout) 


1 P31 = /DAV2/ P36 = RDY2// 


Figure 6-10. Port 3 Mode Register (T,,,,, Operation) 
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The counter/timer to be output is selected by TMR bit 7 and 
bit 6. TO is selected to drive the T,,,, line by setting bit) 7 
to 0 and bit 6 to 1. Likewise, T1 is selected by setting bit 7 
and bit 6 to 1 and O, respectively. The counter/timer T,,,, 
mode is turned off by setting TMR bit and bit 6 both to 0, 


freeing P36 to be a data output line. 
Tour IS initialized to a logic 1 whenever the TMR Load bit (bit 
O for TO or bit 1 for T1) is set to 1. The T,,,, configuration 
timer load, and Timer Enable Count bits for the counter/ 
timer driving the T,,,, pin can be set at the same time. For 
example, using the instruction: 

OR TMR,#43H 
m™ Configures TO to drive the T,,,, pin (P36). 
m Sets the P36 Tout pin to a logic 1 level. 
@ Loads the initial PREO and TO levels into their 


respective counters and starts the counter after the 
M2T2 machine state after the operand is fetched. 


TMR 


IRQ4 
(TO End-of-Count) | 


IRQ5 
(T1 End-of-Count) 


Figure 6-11. TO and T1 Output Through T 


Internal 


Clock 





TMR Dg 
TMRD, 
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At end-of-count, the interrupt request line (IRQ4 or IRQ5), 
clocks a toggle flip-flop. The output of this flip-flop drives 
the T,,,, line, P36. In all cases, when the selected counter/ 
timer reaches its end-of-count, T,,,, toggles to its opposite 
state (Figure 6-11). If, for example, the counter/timer is in 
Continuous Counting Mode, Tout will have a 50 percent 
duty cycle output. This duty cycle can easily be controlled 
by varying the initial values after each end-of-count. 


The internal clock can be selected as output instead of TO 
or T1 by setting TMR bit 7 and bit 6 both to 1. The internal 
clock (XTAL frequency/2) is then directly output on P36 
(Figure 6-12). 

While programmed as T,,,,, P36 cannot be modified by a 
write to port register P3. However, the Z8® software can 
examine the P36 current output by reading the port regis- 
ter. 


D,-D, = 10 


OUT 


Tour 





Figure 6-12. Internal Clock Output Through T,,,, 
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6.5 T,, MODES 

The Timer Mode Register TMR (F7H) (Figure 6-13) is 
used in conjunction with the Prescaler Register PRE1 
(F7H) (Figure 6-14) to configure P31 as T,,. T,, is used in 
conjunction with T1 in one of four modes: 

m External Clock Input 

m Gated Internal Clock 

m Triggered Internal Clock 

m Retriggerable Internal Clock 

Note: The T,, mode is restricted for use with timer 1 only. To 


enable the T,, mode selected (via TMR bits 4- 5), bit 1 of PRE1 
must be set to 1. 


Register F1H 
Timer Mode Register (TMR) 
(Read/Write) 
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The counter/timer clock source must be configured for 
external by setting the PRE1 Register bit 2 to 0. The Timer 
Mode Register bit 5 and bit 4 can then be used to select the 
desired T,, operation. 


For T1 to start counting as aresult of aT, input, the Enable 
Count bit (bit 3 in TMR) must be set to 1. When using T,, as 
an external clock or a gate input, the initial values must be 
loaded into the down counters by setting the Load bit (bit 
2 in TMR) to a 1 before counting begins. In the descriptions 
of T,, that follow, it is assumed the programmer has 
performed these operations. Initial values are automati- 
cally loaded in Trigger and Retrigger modes so software 
loading is unnecessary. 


| | posjost ot TT 
haa Tiny Modes 


00 = External Clock Input 

01 = Gate Input 

10 = Trigger Input nenagsreeer 
11 = Trigger Input (Retriggerable) 


Figure 6-13. Timer Mode Register (T,,, Operation) 


Register F3H 
Prescaler 1 Register (PRE1) 
(Write-Only) 


[07] Ds | bs | b4 | ps} b2 | D1] Do | 
7: oo Clock Source 


0 = T1 Internal 
1= 71 External 


Figure 6-14. Prescaler 1 Register (T,, Operation) 
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It is suggested that P31 be configured as an input line by 
setting P3M Register bit 5 to 0, although T, is still functional 
if P31 is configured as a handshake input . 


6.5.1 External Clock Input Mode 


The T,,, External Clock Input Mode (TMR bit 5 and bit 4 both 
set to 0) supports counting of external events, where an 
event is considered to be a High-to-Low transition on T,, 
(Figure 6-15). 


Internal 
Clock 
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Each High-to-Low transition on T,,, generates an interrupt 
request IRQ2, regardless of the selected T,, mode or 
the enabled/disabled state of Ti. IRQ2 must therefore 
be masked or enabled according to the needs of the 
application. 


Note: See the product data sheet for the minimum allowed T,, 
external clock input period (T, T,,). 


IRQ5 


IRQ2 


Figure 6-15. External Clock Input Mode 
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6.5.2 Gated Internal Clock Mode 


The T,, Gated Internal Clock Mode (TMR bitS and bit4set —_T,, is Low. Interruptrequest IRQ2is generated on the High- 
to O and 1 respectively) measures the duration of an _ to-Low transition of T,, signalling the end of the gate input. 
external event. In this mode, the T1 prescaler is driven by Interrupt request IRQ5 is generated if T1 reaches its end- 
the internal timer clock, gate by a High levelonT,, (Figure  of-count. 

6-16). T1 counts while T,,, is High and stops counting while 


TMR 
D,-D, = 01 
eae 
T \/ \/ 
IN 


Figure 6-16. Gated Clock Input Mode 
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6.5.3 Triggered Input Mode 

The T,, Triggered Input Mode (TMR bits 5 and 4 are set to 
1 and 0 respectively) causes T1 to start counting as the 
result of an external event (Figure 6-17). T1 is then loaded 
and clocked by the internal timer clock following the first 


High-to-Low transition on the T,, input. Subsequent T,,, 
transitions do not affect T1. In the Single-Pass Mode, the 


pa 
\/ \/ 
Trigger 


Internal 
Clock 
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Enable bit is reset whenever T1 reaches its end-of-count. 
Further T,,, transitions will have no effect on T1 until soft- 
ware sets the Enable Count bit again. In Continuous mode, 
once T1 is triggered counting continues until software 
resets the Enable Count bit. Interrupt request IRQ5 is 
generated when T1 reaches its end-of-count. 


IRQS 


IRQ2 


Figure 6-17. Triggered Clock Mode 
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6.5.4 Retriggerable Input Mode 


The T,, Retriggerable Input Mode (TMR bits 5 and 4 are 
set to 1) causes T1 to load and start counting on every 
occurrence of a High-to-Low transition on T,, (Figure 
6-17). Interrupt request IRQ5 will be generated if the 
programmed time interval (determined by T1 prescaler 
and counter/timer register initial values) has elapsed since 
the last High-to-Low transition on T,,,. In Single-Pass Mode, 
the end-of-count resets the Enable Count bit. Subsequent 


6.6 CASCADING COUNTER/TIMERS 


For some applications, it may be necessary to measure a 
time interval greater than a single counter/timer can mea- 
sure. In this case, T,, and T.,,, can be used to cascade T0 
and T1 as a single unit (Figure 6-18). TO should be 
configured to operate in Continuous mode and to drive 
Tour: Fy, Should be configured as an external clock input to 
T1 and wired back to T,,,,. On every other TO end-of-count, 


Toy, undergoes aHigh-to-Lowtransition thatcauses T1 tocount. 
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T,, transitions will not cause T1 to load and start counting 
until software sets the Enable Count bit again. In Con- 
tinuous Mode, counting continues once T1 is triggered 
until software resets the Enable Count bit. When enabled, 
each High-to-Low T,, transition causes T1 to reload and 
restart counting. Interrupt request IRQ5 is generated on 
every end-of-count. 


T1 can operate in either Single-Pass or Continuous mode. 
When the T1 end-of-count is reached, interrupt request 
IRQ5 is generated. Interrupt requests IRQ2 (T,, High-to- 
Low transitions) and IRQ4 (TO end-of-count) are also 
generated but are most likely of no importance in this 
configuration and should be disabled. 





Figure 6-18. Cascaded Counter / Timers 
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6.7 RESET CONDITIONS 


After ahardware reset, the counter/timers are disabled and 
the contents of the counter/timer and prescaler registers 
are undefined. However, the counting modes are config- 
ured for Single-Pass and the T1 clock source is set for 


R242 T1 
Counter/Timer 1 Register 
(%F2; Read/Write Only) 


R244 TO 
Counter/Timer 0 Register 
(%F4; Read/Write Only) 





L initial value when written 


(Range 1-256 decimal, 01-00 HEX) 
Sine value when read 


Figure 6-19. Counter / Timer Reset 
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external. T,, is set for External Clock mode, and the T,,,, 


mode is off. Figures 6-19 through 6-22 show the binary 
reset values of the Prescaler, Counter/Timer, and Timer 


Mode registers. 


R243 PRE1 
Prescaler 1 Register 
(%F3; Write-Only) 


Ed Ce Oe Ce 
1 ounce 


T, Single Pass 
: =T! Modulo-n 


Clock Source 
1=T,, Internal 


O= Ty External (T IN) 


Prescaler Modulo 


Range: 1-64 Decimal 
1-00 HEX) 


Figure 6-20. Prescaler 1 Register Reset 
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R245 PREO 
Prescaler O Register 
(%F5; Write Only) 


Count Mode 

0=T, Single Pass 
i= 1, Modulo-n 
Reserved (Must be 0) 
Prascaler Modulo 


(Range: 1-64 Decimal 
01-00 HEX) 


Figure 6-21. Prescaler 0 Reset 


R241 TMR 
Timer Mode Register 
(% F1; Read/Write) 


pofofofojo jo fo]fo | 
L, 


No Function 


Load Ty 


—_ 
Won 


Disable T.. Count 
Enable To Count 


ok 
tou 


No Function 
Load qT; 


~O 


Disable T, Count 
Enable q; Count 


—~O 


Tin Modes: 
Extemal Clock Input = 00 
Gate Input = 01 


Trigger Input = 10 
(Non-retriggerrable) 


rare 
Tout Modes: 

Tout OFF = 00 

Tg OUT = 01 

T, OUT = 10 

intemal Clock OUT = 11 


Figure 6-22. Timer ModeRBegister Reset 
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CHAPTER 7 
INTERRUPTS 





7.1 INTRODUCTION 


The Z8® microcontroller allows six different interrupt levels 
from a variety of sources; up to four external inputs, the on- 
chip Counter/Timer(s), software, and serial I/O peripher- 
als. These interrupts can be masked and their priorities set 
by using the Interrupt Mask and the Interrupt Priority 
Registers. All six interrupts can be globally disabled by 
resetting the master Interrupt Enable, bit 7 in the Interrupt 
Mask Register, with a Disable Interrupt (DI) instruction. 
Interrupts are globally enabled by setting bit 7 with an 
Enable Interrupt (El) instruction. 












Register HEX Identifier 
Interrupt Mask FBH IMR 
Interrupt Request FAH IRQ 
Interrupt Priorit FOH IPR 


Figure 7-1. Interrupt Control Registers 


There are three interrupt control registers: the Interrupt 
Request Register (IRQ), the Interrupt Mask register (IMR), 
and the Interrupt Priority Register (IPR). Figure 7-1 shows 
addresses and identifiers for the interrupt control registers. 
Figure 7-2 is a block diagram showing the Interrupt Mask 
and Interrupt Priority logic. 


The Z8 MCU family supports both vectored and polled 
interrupthandling. Details on vectored and polled interrupts 
canbefoundiaterinthischapter. 


IRQo-IRQs 
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Global 
Interrupt 
Enable 


Interrupt 
Request 


Vector Select 


Figure 7-2. Interrupt Block Diagram 


Note: See the selected Z8 MCU's product specification for the 
exact interrupt sources supported. 
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7.2 Interrupt Sources 
Table 7-1 presents the interrupt types, Sources, and vectors available in the Z8® family of processors. 


Table 7-1. Interrupt Types, Sources, and Vectors * 





Name Sources Vector Location Comments 
IRQ, DAV, IRQ,, Comparator 0,1 External (P3,), Edge Triggered; Internal 
IRQ, DAV,, IRQ, 2,3 External (P3,), Edge Triggered; Internal 
IRQ, DAV,, IRQ,, TIN, Comparator 4,5 External (P3,), Edge Triggered; internal 
IRQ, 6,7 External (P3,) or (P3,), Edge Triggered; 
IRQ, | Internal 
Serial In 6,7 Internal 
RO Ty 8,9 Internal 
s Serial Out 8,9 Internal 
IRQ, T, 10,14 Internal 





7.2.1 External Interrupt Sources 


External sources involve interrupt request lines IRQO0-IRQ3. IRQO, IRQ1, and IRQ2 can be generated by a transition on 
the corresponding Port 3 pin (P32, P33, and P31 correspond to IRQO, IRQ1, and IRQ2, respectively). Figure 7-3 is a block 
diagram for interrupt sources IRQO, IRQ1, and IRQ2. 





(Internal) 


Figure 7-3. Interrupt Sources IRQ0-IRQ2 Block Diagram 


Note: The interrupt sources and trigger conditions are device dependent. See the device product specification to determine available 
sources (internal and external), triggering edge options, and exact programming details. 
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When the Port 3 pin (P31, P32, or P33) transitions , the first 
flip-flop is set. The next two flip-flops synchronize the 
request to the internal clock and delay it by two internal 
clock periods. The output of the last flip-flop (IRQO, IRQ1, 
or IRQ2) goes to the corresponding Interrupt Request 
Register. 


IRQ3 can be generated from an external source only if 
Serial In is not enabled. Otherwise, its source is internal. 
The external request is generated by a negative edge 
signal on P30 as shown in Figure 7-4. Again, the external 
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requestis synchronized and delayed before reaching IRQ3. 
Some Z8® products replace P30 with P32 as the external 
source for IRQ3. In this case, IRQ3 interrupt generation 
follows the logic as illustrated in Figure 7-3. 


Note: Although interrupts are edge triggered, minimum interrupt 
request Low and High times must be observed for proper 
operation. See the device product specification for exact timing 
requirements on external interrupt requests (T,IL, TlH). 








(IRQ 
Serial In) 
Clock IRQs 
IRQ, External Source Internal 
Source 





Serial Receiver 





Figure 7-4. Interrupt Source IRQ3 Block Diagram 


7.2.2 Internal Interrupt Sources 


Internal sources involve interrupt requests IRQO, IRQ1, IRQ3, IRQ4, and IRQS. Internal sources are ORed with the external 
sources, so either an internal or external source can trigger the interrupt. Internal interrupt sources and trigger conditions 
are device dependent. See the device product specification to determine available sources, triggering edge options, 


and exact programming details. 


For more details on the internal interrupt sources, refer to the chapters describing the Counter/Timer, I/O ports, and Serial 


I/O. 
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7.3 INTERRUPT REQUEST (IRQ) REGISTER LOGIC AND TIMING 


Figure 7-5 shows the logic diagram for the Interrupt Re- 
quest (IRQ) Register. The leading edge of the request will 
set the first flip-flop, that will remain set until interrupt 
requests are sampled. 


Requests are sampled internally during the last clock cycle 
before an opcode fetch (Figure 7-6). External requests are 
sampled two internal clocks earlier, due to the synchroniz- 
ing flip-flops shown in Figures 7-3 and 7-4. 


IRQo-IROQs 





Atsample time the requestis transferred to the second flip- 
flop in Figure 7-5, that drives the interrupt mask and priority 
logic. When an interrupt cycle occurs, this flip-flop will be 
reset only for the highest priority level that is enabled. 


The user has direct access to the second flip-flop by 
reading and writing the IRQ Register. IRQ is read by 
specifying it as the source register of an instruction and 
written by specifying it as the destination register. 


To Mask 
and 
Priority 
Logic 


Figure 7-5. IRQ Register Logic 


Mn M1 2 
Geel net a 


LL 


M 


Interrupt Requests 
Sampled Internally 


External Interrupt 
Requests Sampled 


Figure 7-6. Interrupt Request Timing 
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7.4 INTERRUPT INITIALIZATION 


After reset, all interrupts are disabled and must be initial- 
ized before vectored or polled interrupt processing 
can begin. The Interrupt Priority Register (IPR), Interrupt 
Mask Register (IMR), and Interrupt Request Register (IRQ) 
must be initialized, in that order, to start the interrupt 
process. However, IPR need not be initialized for polled 
processing. 


Register F9H 
Interrupt Priority Register (IPR) 
(Write-Only) 


[27] be] 09] o4f 09} oa} Di] Do 
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7.4.1 Interrupt Priority Register (IPR) 
Initialization 


IPR (Figure 7-7) is a write-only register that sets priorities 
for the six levels of vectored interrupts in order to resolve 
simultaneous interrupt requests. (There are 48 sequence 
possibilities for interrupts.) The six interrupt levels IRQO- 
IRQ5 are divided into three groups of two interrupt requests 
each. One group contains IRQ3 and IRQ5. The second 
group contains IRQO and IRQ2, while the third group 
contains IRQ1 and IRQ4. 


Priorities can be set both within and between groups as 
shown in Tables 7-2 and 7-3. Bits 1, 2, and 5 define the 
priority of the individual members within the three groups. 
Bits 0, 3, and 4 are encoded to define six priority orders 
between the three groups. Bits 6 and 7 are reserved. 


Interrupt Group Priority 
Bits Priority 

000 Reserved 
001 C>A>B 
010 A>B>C 

011 A>C>B 
100 B>C>A 

101 C>B>A 
110 B>A>C 

111 Reserved 


Group C (IRQ1 and IRQ4 Priority) 
0 =IRQ1 > IRQ4 
1 = 1IRQ4 > IRQ1 


Group B (IRQO and IRQ2 Priority) 
0 = IRQ2 > IRQO 
1 = IRQO > IRQ2 


Group A (IRQ3 and IRQ5 Priority) 
0 = IRQ5 > IRQ3 
1 = IRQ3 > IRQ5 


Reserved (Must be 0) 


Figure 7-7. Interrupt Priority Register 
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Table 7-2. Interrupt Priority 





Priority 
Group Bit Value Highest Lowest 
C Bit 1 0 IRQ1 IRQ4 
IRQ4 IRQ1 
B Bit 2 0 IRQ2 IRQO 
7 a IRQO IRQ2 
A Bit 5 0 IRQ5 IRQ3 
1 IRQ3 IRQ5 
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Table 7-3. Interrupt Group Priority 





7.4.2 Interrupt Mask Register (IMR) Initialization 


MR_ individually or globally enables or disables the six 
interrupt requests (Figure 7-8). When bit O to bit 5 are set 
to 1, the corresponding interrupt requests are enabled. Bit 
7 is the master enable and must be set before any of the 
individual interrupt requests can be recognized. Resetting 
bit 7 globally disables all the interrupt requests. Bit 7 is set 
and reset by the El and DI instructions. It is automatically 
reset during an interrupt service routine and set following 
the execution of an Interrupt Return (IRET) instruction. 


Register FBH 
Interrupt Mask Register (IMR) 
(Read/Write) 


[27] b2] D5} D4f va] val os] bo 


Ite 


Bit Pattern Group Priority 

Bit4 BitS Bito High Medium Low 
0 0 0 Not Used 
0 0 1 C A B 
0 1 ) A B C 
0 1 1 A C B 
1 0 0 B C A 
1 ) 1 C B A 
1 1 0 B A C 
1 1 1 Not Used 

Note: Bit 7 must be reset by the DI instruction before the 


contents of the Interrupt Mask Register or the Interrupt 
Priority Register are changed except: 


m Immediately after a hardware reset. 


m@ Immediately after executing an interruptservice routine 
and before IMR bit 7 has been set by any instruction. 


0 = Disables IRQO 
1 = Enables IRQO 


0 = Disables IRQ1 
1 = Enables IRQ1 
0 = Disables IRQ2 
1 = Enables IRQ2 


0 = Disables IRQ3 
1 = Enables IRQ3 


0 = Disables IRQ4 
1 = Enables IRQ4 


0 = Disables IRQ5 
1 = Enables IRQ5 


0 = Disable RAM Protect 
1 = Enable RAM Protect 


0 = Disables Interrupts 
1 = Enables Interrupts 


Figure 7-8. Interrupt Mask Register 


Note: The RAM Protect option is selected at ROM mask submission time or at EPROM program time. If not selected or not an available 


option, this bit is reserved and must be 0. 
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7.4.3 Interrupt Request (IRQ) Register Initialization 


IRQ (Figure 7-9) is a read/write register that stores the 
interrupt requests for both vectored and polled interrupts. 
When an interrupt is made on any of the six levels, the 
corresponding bit position in the register is set to 1. BitO to 
bit 5 are assigned to interrupt requests IRQO to IRQ5, 
respectively. 


Whenever Power-On Reset (POR) is executed, the IRQ 
resister is reset to OOH and disabled. Before the IRQ 
register willaccept requests, it must be enabled by execut- 
ing an ENABLE INTERRUPTS (El) instruction. 


Register FAH 


Note: Setting the Global Interrupt Enable bit in the Interrupt Mask 
Register (IMR, bit 7) will not enable the IRQ. Execution of the El 
instructionisrequired(Figure 7-10). 


For polled processing, IRQ must still be initialized by an El 
instruction. 


To properly initialize the IRQ register, the following code is 
provided: 


CLR 
EI 
DI 


IMR 


Interrupt Request Register (IRQ) 
e 


(Read/Write) 


27] be] o5] o4] D9] D2} os} Do 


Lo 


0 = IRQO Reset 
1 = IRQO Set 


0 = IRQ1 Reset 
1 = IRQ1 Set 
0 = IRQ2 Reset 
1 = IRQ2 Set 


0 = IRQ3 Reset 
1 = IRQ3 Set 


0 = IRQ4 Reset 
1 = IRQ4 Set 


0 = IRQS Reset 
1 = IRQ5 Set 


Reserved /Int Edge Select 


Figure 7-9. Interrupt Request Register 
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IMR is cleared before the IRQ enabling sequence to insure 
no unexpected interrupts occur when El is executed. This 
code sequence should be executed prior to programming 
the application required values for IPR and IMR. 


Note: IRQ bits 6 and 7 are device dependent. When reserved, 
the bits are not used and will return aO when read. When used as 
the Interrupt Edge select bits, the configuration options are as 
show in Table 7-4. 


Table 7-4. IRQ Register Configuration 





IRQ interrupt Edge 
D7 D6 P31 P32 
0 0 F F 
0 1 F R 
1 0 R F 
1 1 R/F R/F 
Note: 
F = Falling Edge 
R = Rising Edge 






EI! Instruction 


Power-On Reset (POR) 
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The proper sequence for programming the interrupt edge 
select bits is (assumes IPR and IMR have been previously 
initialized): 


DI ‘Inhibit all interrupts 
till input edges are 
configured. 
‘Configure interrupt 
edges as needed - 


OR IRQ,#XX 000000B 


do not disturb 
IRQ 0-5. 

E| ‘Re-enable inter- 
rupts. 






Interrupt Request Register 
(IRQ, FAH 





Figure 7-10. IRQ Reset Functional Logic Diagram 
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7.5 IRQ SOFTWARE INTERRUPT 
GENERATION 


IRQ can be used to generate software interrupts by speci- 
fying IRQ as the destination of any instruction referencing 
the Z8® Standard Register File. These Software Interrupts 
(SWI) are controlled in the same manner as hardware 
generated requests (in other words, the IPR and the IMR 
control the priority and enabling of each SWI level). 


To generate a SWI, the desired request bit in the IRQ is set 
as follows: 


OR IRQ, #NUMBER 


7.6 VECTORED PROCESSING 

Each Z8 interrupt level has its own vector. When an 
interrupt occurs, control passes to the service routine 
pointed to by the interrupt’s vector location in program 


memory. The sequence of events for vectored interrupts is 
as follows: 


SP and STACK before an Interrupt 


Top of Stack 
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where the immediate data, NUMBER, has a_1 in the bit 
position corresponding to the level of the SWI desired. For 
example, if an SWI is desired on IRQ5, NUMBER would 
have a 1 in bit 5: 


OR IRQ, #00100000B 


With this instruction, if the interrupt system is globally 
enabled, IRQ5 is enabled, and there are no higher priority 
pending requests, control is transferred to the service 
routine pointed to by the IRQ5 vector. 


PUSH PC Low Byte on Stack 

PUSH PC High Byte on Stack 

PUSH FLAGS on Stack 

Fetch High Byte of Vector 

Fetch Low Byte of Vector 

Branch to Service Routine specified by Vector 


Figures 7-11 and 7-12 show the vectored interrupt opera- 
tion. 


SP and STACK after an Interrupt 







PC LOW Byte 


PC HIGH Byte 


FLAGS 


Figure 7-11. Effects of an Interrupt on the STACK 
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Program Memory 


XXFFH 






Interrupt 
Service 
Routine 


Vector Selected 
By Priority Logic 


Interrupt 
Vector Table 


0000H 


Figure 7-12. Interrupt Vectoring 
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7.6.1 Vectored Interrupt Cycle Timing 


The interrupt acknowledge cycle time is 24 internal clock 
cycles and is shown in Figure 7-13. In addition, two internal 
clock cycles are required for the synchronizing flip-flops. 
The maximum interrupt recognition time is equal to the 
number of clock cycles required for the longest executing 
instruction present in the user program (assumes worst 
case condition of interrupt sampling, Figure 7-6 , just prior 
to the interrupt occurrence). To calculate the worst case 
interrupt latency (maximum time required from interrupt 
generation to fetch of the first instruction of the interrupt 
service routine), sum these components: 


Worst Case Interrupt Latency = 24 TpC (interrupt acknowl- 
edge time) + #T,C of longest instruction present in the 
user's application program + 2T,C (internal synchroniza- 
tion time). 
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VECT+1 ae 


First Inetruction Of interrupt Service Routine 


Fetch 


Fm nr ere M2 rrr MF a ntifetinn Stack Push —pfege——— Stack Push —————#e jeg Stack Push ——p-fqe-=—— Vector High ——t>g—— Vector Low $e fen M1 fee M2 


nmiaa> bE 


tr] 


Fetch 
For Stack Extemal Only 


[ses] races | 
Even Vector Addrees 


& 
! 
Hi 
El 
| 
| 
El 


Figure 7-13. Z8 Interrupt Acknowledge Timing 
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7.6.2 Nesting of Vectored Interrupts 


Nesting of vectored interrupts allows higher priority re- 
quests to interrupt a lower priority request. To initiate 
vectored interrupt nesting, do the following during the 
interrupt service routine: 


m Push the old IMR on the stack. 

m@ Load IMR with a new mask to disable lower priority 
interrupts. 

m Execute El instruction. 
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Proceed with interrupt processing. 

After processing is complete, execute DI instruction. 
Restore the IMR to its original value by returning the 
previous mask from the stack. 

Execute IRET. 


Depending on the application, some simplification of the 
above procedure may be possible. 





7.7 POLLED PROCESSING 


Polled interrupt processing is supported by masking off the 
IRQ levels to be polled. This is accomplished by clearing 
the corresponding bits in the IMR. 


Toinitiate polled processing, check the bits of interestinthe 
IRQ using the Test Under Mask (TM) instruction. If the bit 
is set, call or branch to the service routine. The service 
routine services the request, resets its Request Bit in the 
IRQ, and branchesor returns back to the main program. An 
example of a polling routine is as follows: 


7.8 RESET CONDITIONS 


Upon reset, all bits in IPR are undefined. 
In IMR, bit 7 is O and bits 0-6 are undefined. The IRQ 


register is reset and held in that state until an enable 
interrupt (El) instruction is executed. 
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™ IRQ, #MASKA _ ;Test for request 


JR Z, NEXT ‘If no request go to NEXT 
CALL SERVICE ;lf request is there, then 
‘service it 
NEXT: 
SERVICE: ;Process Request 


AND IRQ, #MASKB 
RET 


‘Clear Request Bit 
‘Return to next 


In this example, if IRQ2 is being polled, MASKA will be 
0Q0000100B and MASKB will be 11111011B. 
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8.1 INTRODUCTION 


USER'S MANUAL 


CHAPTER 8 
POWER-DOWN MODES 


In addition to the standard RUN mode, the Z8® supports two Power-Down modes to minimize device current consumption. 


The two modes supported are HALT and STOP. 


8.2 HALT MODE OPERATION 


The HALT mode suspends instruction execution and turns 
off the internal CPU clock. The on-chip oscillator circuit 
remains active so the internal clock continues to run and is 
applied to the Counter/Timer(s) and interrupt logic. 


To enter the HALT mode, it is necessary to first flush the 
instruction pipeline to avoid suspending execution in mid- 
instruction. To do this, the application program must ex- 
ecute a NOP instruction (opcode = FFH) immediately 
before the HALT instruction (opcode 7Fb), that is, 


FF NOP _ ;clear the instruction pipeline 
7F HALT ;enter HALT mode 


The HALT mode is exited by interrupts, either externally or 
internally generated. Upon completion of the interrupt 
service routine, the user program continues from the in- 
struction after HALT. 


The HALT mode may also be exited via a POR/RESET 
activation or a Watch-Dog Timer (WDT) timeout. (See the 
product data sheet for WDT availability). In this case, 
program execution will restart at the reset restart address 
OOOCH. 


To further reduce power consumption in the HALT mode, 
some Z8 family devices allow dynamic internal clock scal- 
ing. Clock scaling may be accomplished on the fly by 
reprogramming bit 0 and/or bit1 ofthe STOP-Mode Recov- 
ery register (SMR). See Figure 8-1. 


Note: Internal clock scaling directly effects Counter/Timer 
operation — adjustment of the prescaler and downcounter 
values may be required. To determine the actual HALT 
mode current (I,,,) value for the various optional modes 
available, see the selected Z8® device’s product specifi- 
cation. 
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8.3 STOP MODE OPERATION 


The STOP mode provides the lowest possible device 
standby current. This instruction turns off the on-chip 
oscillator and internal system clock. 


To enter the STOP mode, it is necessary to first flush the 
instruction pipeline to avoid suspending execution in mid- 
instruction. To do this, the application program must 
execute a NOP instruction (opcode=FFH) immediately 
before the STOP instruction (opcode=6FH), that is, 


FF NOP __ ;clear the instruction pipeline 
6F STOP ;enter STOP mode 


The STOP mode is exited by any one of the following 
resets: Power-On Reset activation, WDT time out (if 
available), ora STOP-Mode Recovery source. Upon reset 
generation, the processor will always restart the applica- 
tion program at address OOOCH. 


POR/RESET activation is present on all Z8 devices and is 
implemented as a reset pin and/or an on-chip power on 
reset circuit. 


Some Z8 devices allow for the on-chip WDT to run in the 
STOP mode. If so activated, the WDT timeout will generate 
a reset some fixed time period after entering the STOP 
mode. 


Note: STOP-Mode Recovery by the WDT will increase the STOP 
mode standby current (I,,,). This is due to the WDT clock and 
divider circuitry that is now enabled and running to support this 
recovery mode. See the product data sheet for actual Icc2 
values. 


AllZ8 devices provide some form of dedicated STOP-Mode 
Recovery (SMR) circuitry. Two SMR methods are imple- 
mented — a single fixed input pin or a flexible, program- 
mable set of inputs. The selected Z8 device product speci- 
fication should be reviewed to determine the SMR options 
available for use. 


Note: For devices that support SPI, the slave mode compare 
feature also serves as a SMR source. 
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In the simple case, a low level applied to input pin P27 will 
trigger aSMR. Touse this mode, pin P27 (I/O Port 2, bit 7) 
must be configured as an input before the STOP mode is 
entered. The low level on P27 must meet aminimum pulse 
width Tyoy- (See the product data sheet) to trigger the 
device reset mode). Some Z8 devices provide multiple 
SMR input sources. The desired SMR source is selected 
via the SMR Register. 


Note: Use of specialized SMR modes (P2.7 input or SMR 
register based) or the WDT timeout (only when in the STOP 
mode) provide a unique reset operation. Some control 
registers are initialized differently for a SMR/WDT trig- 
gered POR than a. standard reset operation. See the 
product specification (register file map) for exact details. 


To determine the actual STOP mode current (I...) value for 

the optional SMR modes available, see the selected Z8 

device's product data sheet. 

Note: The STOP mode current (1,,,) will be minimized when: 

m V,, is at the low end of the devices operating range. 
WDT is off in the STOP mode. 


a 
m@ Output current sourcing is minimized. 
a 


All inputs (digital and analog) are at the low or high rail 
voltages. 
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8.4 STOP-Mode Recovery Register (SMR) 


This register selects the clock divide value and determines the mode of STOP-Mode Recovery (Figure 8-1). All bits are 
Write-Only, except bit 7, that is Read-Only. Bit 7 is a flag bit that is hardware set on the condition of STOP recovery and 
reset by a power-on cycle. Bit 6 controls whether a low level or a high level is required from the recovery source. Bit 5 
controls the reset delay after recovery. Bits 2, 3, and 4, of the SMRregister, specify the source of the STOP-Mode Recovery 


signal. Bits O and 1 control internal clock divider circuitry. The SMR is located in Bank F of the Expanded Register File 
at address OBH. 


SMR (FH) 0B 


>7] 6] bs] 04] os] o2] 01} po. 


L. SCLK/TCLK Divide-by-16 
OQ OFF ** 
1 ON 


External Clock Divide by 2 
0 SCLK/TCLK =XTAL/2* 
1 SCLK/TCLK =XTAL 


STOP-Mode Recovery Source 

000 POR Only and/or External Reset* 
001 P30 

010 P31 

O11 P32 

100 P33 

101 P27 

110 P2NOR0-3 

111 P2 NOR 0-7 


Stop Delay 

Q OFF 

1 ON* 

Stop Recovery Level 
0 Low* 

1 High 

Stop Flag (Read only) 


0 POR* 


1 Stop Recovery 
* Default setting after RESET. 


** Default setting after RESET and STOP-Mode Recovery. 


Figure 8-1. STOP-Mode Recovery Register 
(Write-Only Except Bit D7, Which Is Read-Only) 


Note: The SMR register is available in select Z8 MCU products. Refer to the device product specification to determine SMR options 
available. 
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SCLK/TCLK Divide-by-16 Select (DO). This bit of the 
SMR controls a divide-by-16 prescaler of SCLK/TCLK. The 
purpose of this control is to selectively reduce device 
power consumption during normal processor execution 
(SCLK control) and/or HALT mode (where TCLK sources 
counter/timers and interrupt logic). 


External Clock Divide-by-Two (D1). This bit can elimi- 
nate the oscillator divide-by-two circuitry. When this bit is 
0, the System Clock (SCLK) and Timer Clock (TCLK) are 
equal to the external clock frequency divided by two. The 
SCLK/TCLK is equal to the external clock frequency when 
this bit is set (D1=1). Using this bit together with D7 of 
PCON helps further lower EMI (D7 (PCON) =0, D1 (SMR) 
=1). The default setting is zero. 


STOP-Mode Recovery Source (D2, D3, and D4). These 
three bits of the SMR specify the wake-up source of the 
STOPrecovery and(Table8-1andFigure8-2). 


Table 8-1. STOP-Mode Recovery Source 


SMR: 432 Operation 
D4 D3 D2 Description of Action 
0 0 0 POR and/or external reset recovery 
0 0 1 P30 transition 
0 1 0 P31 transition (not in Analog Mode) 
0 1 1 P32 transition (not in Analog Mode) 
1 0 0 P33 transition (not in Analog Mode) 
1 Q 1 P27 transition 
1 1 0 Logical NOR of P20 through P23 
1 1 1 Logical NOR of P20 through P27 
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STOP-Mode Recovery Delay Select (D5). This bit, if High, 
enables the T,, /RESET delay after Stop-Mode Recovery. 
The default configuration of this bitis 1. Ifthe “fast” wake up 
is selected, the Stop-Mode Recovery source is kept active 
for at least 5 TpC. 


STOP-Mode Recovery Edge Select (D6). A 1 in this bit 
position indicates that a high level on any one of the 
recovery sources wakes the Z8® from STOP mode. A 0 
indicates low-level recovery. The default is 0 on POR 
(Figure 8-2). 


Cold or Warm Start (D7). This bitis set by the device upon 
entering STOP mode. A Oin this bit (cold) indicates that the 
device reset by POR/WDT RESET. A 1 in this bit (warm) 
indicates that the device awakens by a SMR source. 
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SMR D4 D3 D2 
000 
VDD SMR D4 D3 D2 SMR D4 D3 D2 SMR D4 D3 D2 SMR D4 D3 D2 SMR D4 D3 D2 
00 1 10 #0 10 1 17 £=#0 11 1 
01 0 
011 


P20 P20 
P30 . 
P31 . P33 > P27 pe ) > ‘)} +> 
P32 

P23 P27 








To POR 
RESET 
rit — 
Stop Mode Recovery Edge 
Select (SMR) 
To P33 Data 


Latch and iIRQ1 


P33 From Pads 


Digital/Analog Mode 
Select (P3M) 


Figure 8-2. STOP-Mode Recovery Source 


Note: |f P31, P32, or P33 are to be used for a SMR source, the digital mode of operation must be selected prior to entering the STOP 
Mode. 
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CHAPTER 9 
SERIAL 1/0 
9.1 UART INTRODUCTION 


Select Z8® microcontrollers contain an on-board full-du- —_ tworregisters, the receiver buffer and the transmitter buffer, 
plex Universal Asynchronous Receiver/Transmitter(UART) — which are used in conjunction with Counter/Timer TO and 
for data communications. The UART consists of a Port 3 1/O lines P30 (input) and P37 (output). Counter/Timer 
Serial I/O Register (SIO) located at address FOH, andits TO provides the clock input for control of the data rates. 
associated control logic (Figure 9-1). The SIO is actually 


internal Data Bus 






Read FOH 
| QO 
Stop IRO4 
Receiver Transfer Bit Detect 
Buffer 
ark 


LU Transmitter Serial p 
P3, Serial Receiver Char Shift Register > Out 37 
In Shift Register Detect 











Shift 
Clock 


Parity 
Ea 





IRQ3 


Serial 
I/O Clock 
(From TO) 


Figure 9-1. UART Block Diagram 
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Configuration of the UART is controlled by the Port 3 Mode 
Register (P3M) located at address F7H. The Z8® always 
transmits eight bits between the start and stop bits (eight 
Data Bits or seven Data Bits and one Parity Bit). Odd parity 
generation and detection is supported. 


The SIO Register and its associated Mode Control Regis- 
ters are mapped into the Standard Z8 Register File as 
shown in Table 9-1. The organization allows the software to 
access the UART as general-purpose registers, eliminat- 
ing the need for special instructions. 


9.2 UART BIT-RATE GENERATION 


When Port 3 Mode Register bit 6 is set to 1, the UART is 
enabled and TO automatically becomes the bit rate gen- 
erator (Figure 9-2). The end-of-count signal of TO no longer 


Register F7H 
(Write-Only) 


[07 | be fps J bs] os J o2| o1 | bo) 
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Table 9-1. UART Register Map 


Register Hex 
Name identifier Address 
Port 3 Mode P3M F7 
TO Prescaler PREO F5 
Timer/CounterO TO F4 
Timer Mode TMR F1 
UART SIO FO 


generates Interrupt Request IRQ4. Instead, the signal is 
used as the input to the divide-by-16 counters (one each 
for the receiver and the transmitter) that clock the data 
stream. 


jie ee 0 = P30 Input and P37 Output 


1 = P30 Serial In and P37 Serial Out 


Figure 9-2. Port 3 Mode Register (P3M) and 
Bit-Rate Generation 


The divide chain that generates the bit rate is shown in 
Figure 9-3. The bit rate is given by the following equation: 


Bit Rate = XTAL Frequency/(2 x 4x p xtx 16) 


where p and t are the initial values in PrescalerO and 
Counter/TimerO, respectively. The final divide-by-16 is 
required since TO runs at 16 times the bit rate in order to 
synchronize on the incoming data. 


PREO TO 


Figure 9-3. Bit Rate Divide Chain 


To configure the Z8 for a specific bit rate, appropriate 
values as determined by the above equation must be 
loaded into registers PREO 


(F5H) and TO (F4H). PREO also controls the counting mode 
for TO and should therefore be set to the Continuous Mode 
(DO = 1). 
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For example, given an input clock frequency (XTAL) of = Table 9-2 lists several commonly used bit rates and the 
11.9808 MHz and a selected bit rate of 1200 bits per values of XTAL, p, and t required to derive them. This list 
second, the equation is satisfied by p = 39 andt=2. _ is presented for convenience and is not intended to be 
Counter/Timer TO should be set to 02H. With TOinContinu-  —_ exhaustive. 

ous Mode, the value of PREO becomes 9DH (Figure 9-4). 





Table 9-2. Bit Rates 





Bit 7,3728 7,9872 9,8304 11,0592 11,6736 11,9808 12,2880 
Rate p t p t p t p t p t p t p t 
19200 3 1 - - 4 1 _ - - - - 5 1 

960 3 2 - - 4 2 9 1 - - - _ 5 2 

4800 3 4 B 1 4 4 9 2 9 1 - _ 5 4 

2400 3 8 B 2 4 8 9 4 9 2 ) 1 5 8 

1200 3 66 B 4 4 6 9 8 9 4 D 2 5 6 

€00 3. 2 B 8 4 2 9 6 9 8 © 5) 4 5 @ 
660 3. B +6 4 €& 9 2 9 6 cS) 8 5 & 
16) 3 18 B @ 4 18 9 A 9 4 co) 6 5 1B 
110 3 16 3 18 4 1% 5 157 4 ay 17 s @) 8B 10 
Register FSH 
(Write-Only) 


[07 | bs | 0s | bs | 3 | b2 | 1 Do | 
‘Ess ye a aig 


= T0 Single Pass 
1 = TO Modulo-n 


cet 1-64 decimal, 01H-00H) 
Range: 1-64) 


Figure 9-4. Prescaler 0 Register (PREO) Bit-Rate Generation 
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The bit rate generator is started by setting the Timer Mode 
Register (TMR) (F1H) bit 1 and bit 0 both to 1 (Figure 9-5). 
This transfers the contents of the Prescaler 0 Register and 


Register F1H 
(Read/Write) 
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Counter/TimerO Register to their corresponding down 
counters. In addition, counting is enabled so that UART 
operations begin. 


[07 | 06] Ds } D4 bs | b2 } D1 J Do | 


ewe 0 = No Function 


1 = Load TO 


0 = Disable TO Count 
1 = Enable TO Count 


Figure 9-5. Timer Mode Register (TMR) Bit Rate Generation 


9.3 UART RECEIVER OPERATION 


The receiver consists of a receiver buffer (SIO Register 
[FOH]), aserial-in, parallel-out shift register, parity check- 
ing, and data synchronizing logic. The receiver block 
diagram is shown as part of Figure 9-1. 


9.3.1 Receiver Shift Register 


After ahardwareresetor after acharacter hasbeen received, the 
Receiver Shift Register is initialized to all 1s and the shiftclockis 
stopped. Serial data, input through Port 3 bit O, is synchro- 
nized to the internal clock by two D-type flip-flops before 
being input to the Shift Register and the start bit detection 
circuitry. 


Start Bit Transition Detected 


(R) 
RCVR 
Data 


Shift 
Clock 
Eight TO Counts Later Shifting Starts 


RCVR 
IRQ3 


The start bit detection circuitry monitors the incoming data 
stream, looking for a start bit (a High-to-Low input transi- 
tion). When a start bit is detected, the shift clock logic 
is enabled. The TO input is divided-by-16 and, when the 
count equals eight, the divider outputs a shift clock. This 
clock shifts the start bit into the Receiver Shift Register 
at the center of the bit time. Before the shift actually occurs, 
the input is rechecked to ensure that the start bit is valid. If 
the detected start bit is false, the receiver is reset and 
the process of looking for a start bit is repeated. If the 
start bit is valid, the data is shifted into the Shift Register 
every sixteen counts until a full character is assembled 
(Figure 9-6). 


Stop Bit 
One or More 





Shift Register Contents 
Transferred to Receiver Buffer 
and IRQ3 is Generated 


Figure 9-6. Receiver Timing 
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After a full character has been assembled in the receiver’s 
buffer, SIO Register (FOH), Interrupt Request IRQ3 is 
generated. The shift clock is stopped and the Shift Regis- 
ter reset to all 1s. The start bit detection circuitry begins 
monitoring the data input for the next start bit. This cycle 
allows the receiver to synchronize on the center of the bit 
time for each incoming character. 


9.3.2 Overwrites 


Although the receiver is single buffered, it is not protected 
from being overwritten, so the software must read the SIO 
Register (FOH) within one character time after the interrupt 
request (IRQ3). The Z8 does not have a flag to indicate this 
overrun condition. If polling is used, the IRQ3 bit in the 
Interrupt Request Register must be reset by software. 


Received Data 
(No Parity) 
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9.3.3 Framing Errors 


Framing error detection is not supported by the receiver 
hardware, but by responding to the interrupt request within 
one character bittime, the software can test for astop biton 
P30. Port3 bits are always readable, which facilitates break 
detection. For example, if a null character is received, 
testing P30 results in a O being read. 


9.3.4 Parity 


The data format supported by the receiver must have a start 
bit, eight data bits, and at least one stop bit. If parity is on, 
bit 7 of the data received will be replaced by a Parity Error 
Flag. A parity error sets bit 7 to 1, otherwise, bit D7 is set 
to 0. Figure 9-7 shows these data formats. 


SP] Dy | Bg} Ds | D4 J Ds | D2 | Ds | Oo | ST. 


| LL Start Bit 
Eight Data Bits 


Received Data 
(With Parity) 


One Stop Bit 


SP] P D6} Ds |} Ps | D2} Ds | Dy | ST 


| | Start Bit 
Seven Data Bits 
Parity Error Flag 


One Stop Bit 


Figure 9-7. Receiver Data Formats 
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The Z8® hardware supports odd parity only, that is enabled 
by setting the Port 3 Mode Register bit 7 to 1 (Figure 9-8). 


Register F7H 
(Write-Only) 
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If even parity is required, the Parity Mode should be 
disabled (P3M bit 7 set to 0), and software must calculate 
the received data’s parity. 


07 | Dé | D5} D4 | D3] D2 D1 | Do 
[cae O = Parity Off 


1 = Parity On 


Figure 9-8. Port 3 Mode Register (P3M) Parity 


9.4 TRANSMITTER OPERATION 


The transmitter consists of a transmitter buffer (SIO Regis- 
ter [FOH]), a parity generator, and associated control 


logic. The transmitter block diagram is shown as part of 
Figure 9-1. 


After a hardware reset or after a character has been 
transmitted, the transmitter is forced to a marking state 
(output always High) until a character is loaded into the 
transmitter buffer, SIO Register (FOH). The transmitter is 
loaded by specifying the SIO Register as the destination 
register of any instruction. 


TO’s output drives a divide-by-16 counter that in turn 
generates a shift clock every 16 counts. This counter is 
reset when the transmitter buffer is written by an instruc- 
tion. This reset synchronizes the shift clock to the software. 
The transmitter then outputs one bit per shift clock, through 
Port 3 bit 7, until a start bit, the character written to the 
buffer, and two stop bits have been transmitted. After the 
second stop bit has been transmitted, the output is again 
forced to a marking state. Interrupt request IRQ4 is gener- 
ated at this time to notify the processor that the transmitter 
is ready to accept another character. 


9.4.1 Overwrites 


The user is not protected from overwriting the transmitter, 
so itis up to the software to respond to IRQ4 appropriately. 
If polling is used, the IRQ4 bit in the Interrupt Request 
Register must be reset. 


9.4.2 Parity 


The data format supported by the transmitter has a start bit, 
eight data bits, and at least two stop bits. If parity is on, bit 
7 of the data transmitted will be replaced by an odd parity 
bit. Figure 9-9 shows the transmitter data formats. 


Parity is enabled by setting Port 3 Mode Register bit 7 to 1. 
If even parity is required, the parity mode should be 
disabled (P3M bit 7 reset to 0), and software must modify 
the data to include even parity. 


Since the transmitter can be overwritten, the user is able to 
generate a break signal. This is done by writing null 
characters to the transmitter buffer (SIO Register [FOH)) at 
a rate that does not allow the stop bits to be output. Each 
time the SIO Register is loaded, the divide-by-16 counter 
is resynchronized and a new start bit is output followed by 
data. 


A eildis Z8® MICROCONTROLLERS 
Transtno Panty) LSP [SP] | Pe [Ds]. [Ds] D2 | Ds | Po 
| Start Bit 
Eight Data Bits 
Two Stop Bits 
Trantwith Panty ~LSP[SP] P| De] Ds [.] Ds | D2 | 0 | Do 


| Start Bit 
Seven Data Bits 
Odd Parity 


Two Stop Bit 





Figure 9-9. Transmitter Data Formats 
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9.5 UART RESET CONDITIONS 


After a hardware reset, the SIO Register contents are undefined, and Serial Mode and parity are disabled. Figures 9-10 
and 9-11 show the binary reset values of the SIO Register and its associated mode register P3M. 


ue ju fey 
ee Serial Data (Dy = LSB) 


Figure 9-10. SIO Register Reset 


pofofofojfofofofo 
je 0 Port 2 pull-ups open-drain 


1 Port 2 pull-ups active 


0 P32 = Input P35 = Output 

1 P32=/DAVO/RDYO P35 =RDYO//DAVO 
00 P33 = Input P34 = Output 

04 P33 = Input P34 = /DM 


11 P33 =/DAV1/RDY1 P34 = RDY1//DAV1 


O P31 = Input (Ty) P36 = Output (Toy7) 
1 P31 =/DAV2/RDY2 P36 =RDY2//DAV2 


0 P30 = Input P37 = Output 

1 P30 = Serial In P37 = Serial Out 
0 Parity Off 

1 Parity On 


Figure 9-11. P3M Register Reset 
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9.6 Serial Peripheral Interface (SPI) 


Select Z8® microcontrollers incorporate a serial peripheral 
interface (SPI) for communication with other 
microcontrollers and peripherals. The SPI includes fea- 
tures such as Stop-Mode Recovery, Master/Slave selec- 
tion, and Compare mode. Table 9-3 contains the pin 
configuration for the SPI feature when it is enabled. The SPI 
consists of four registers: SPI Control Register (SCON), SPI 
Compare Register (SCOMP), SPI Receive/Buffer Register 
(RxBUF), and SPI Shift Register. SCON is located in bank 
(C) of the Expanded Register File at address 02. 


Table 9-3. SPI Pin Configuration 


Name Function Pin Location 
DI Data-In P20 
DO Data-Out P27 
SS Slave Select P35 
SK SPI Clock P34 





The SPI Control Register (SCON) (Figure 9-12), is a read/ 
write register that controls Master/Slave selection, inter- 
rupts, clock source and phase selection, and error flag. Bit 
0 enables/disables the SPI with the default being SPI 
disabled. A 1 in this location will enable the SPI, and a O will 
disable the SPI. Bits 1 and 2 of the SCON register in Master 
Mode select the clock rate. The user may choose whether 
internal clock is divide-by-2, 4, 8, or 16. In Slave Mode, Bit 
1 of this register flags the user if an overrun of the RxBUF 
Register has occurred. The RxCharOverrun flag is only 
reset by writing a 0 to this bit. In slave mode, bit 2 of the 

Control Register disables the data-out I/O function. Ifa 1is 
written to this bit, the data-out pin is released to its original 
port configuration. If a O is written to this bit, the SPI shifts 
out one bit for each bit received. Bit 3 of the SCON Register 
enables the compare feature of the SPI, with the default 
being disabled. When the compare feature is enabled, a 
comparison of the value in the SCOMP Register is made 
with the value in the RxBUF Register. Bit 4 signals that a 
receive character is available in the RxBUF Register. 


SCON (C) 02 


107 ds] 0s | 04} 03] ba} 01 | bo) 


L_ SPI Enable 

0 Disable * 

1 Enable 
RxCharOverrun (S) 
O Reset 

1 Overrun 
CLK Divide (M) 

00 TCLK/2 

01 TCLK/4 

10 TCLK/8 

11 TCLK/16 
DO SPI Port Enable (S) 
0 SPI DO Port Enabled 
1 DO Port to I/O 
Compare Enable 
O Enable 

1 Disable * 
RxCharAvail 

O Reset 

1 Char. Avail. 
Clock Phase 

O Trans/Fall 

_1 Trans/Rise 
CLK Source 

0 TCLK 

1 Timer O Output 


Master Slave 
0 Slave 


(S) Used with Bit D7 equal to 0 1 Master 


(M) Used with Bit D7 equal to 1 


* Default Setting After Reset. 


Figure 9-12. SPI Control Register (SCON) 


If the associated IRQ3 is enabled, an interrupt is gener- 
ated. Bit 5 controls the clock phase of the SPI. A 1 in bit 5 
allows for receiving data on the clock’s falling edge and 
transmitting data on the clock’s rising edge. A O allows 
receiving data on the clock’s rising edge and transmitting 
onthe clock’s falling edge. The SPI clock source is defined 
in bit 6. A 1 uses TimerO output for the SPI clock, and a0 
uses TCLK for clocking the SPI. Finally, bit 7 determines 
whether the SPI is used as a Master or a Slave. A 1 puts the 
SPI into Master mode and a0 puts the SPI into Slave mode. 
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9.7 SPI Operation 


The SPI is used in one of two modes: either as system 
slave, or as system master. Several of the possible system 
configurations are shown in Figure 9-13. In the slave mode, 
data transfer starts when the slave select (SS) pin goes 
active. Datais transferred into the slave’s SPI Shift Register 
through the DI pin, which has the same address as the 
RxBUF Register. After a byte of data has been received by 
the SPI Shift Register, a Receive Character Available 
(RCA/IRQ3) flag and interrupt is generated. The next byte 
of data will be received at this time. The RxBUF Register 
must be cleared, or a Receive Character Overrun 
(RxCharOverrun) flag will be set in the SCON Register, and 
the data in the RxBUF Register will be overwritten. When 
the communication between the master and slave is com- 
plete, the SS goes inactive. 


Unless disconnected, for every bit that is transferred into 
the slave through the DI pin, a bit is transferred out through 
the DO pin on the opposite clock edge. During slave 
operation, the SPI clock pin (SK) is an input. In master 
mode, the CPU must first activate a SS through one of its 
\/O ports. Next, data is transferred through the master’s DO 
pin one bit per master clock cycle. Loading data into the 
shift register initiates the transfer. In master mode, the 
master’s clock will drive the slave’s clock. At the conclu- 
sion of a transfer, a Receive Character Available (RCA/ 
IRQ3) flag and interrupt is generated. Before data is 
transferred via the DO pin, the SPI Enable bit in the SCON 
Register must be enabled. 
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9.8 SP] Compare 


When the SPI Compare Enable bit, DS of the SCON 
Register is set to 1, the SPi Compare feature is enabled. 
The compare feature is only valid for slave mode. A 
compare transaction begins when the(SS) line goes active. 
Data is received as if it were anormal transaction, but there 
is no data transmitted to avoid bus contention with other 
slave devices. When the compare byte is received, IRQ3 is 
not generated. Instead, the data is compared with the 
contents of the SCOMP Register. If the data does not 
match, DO remains inactive and the slave ignores all data 
until the (SS) signal is reset. If the data received matches 
the data in the SCOMP register, then a SMR signal is 
generated. DO is activated if it is not tri-stated by D2 in the 
SCON Register, and data is received the same as any other 
SPI slave transaction. 


When the SPI is activated as a slave, it operates in all 
system modes: STOP, HALT, and RUN. Slaves’ not com- 
paring remain in their current mode, whereas slaves’ 
comparing wake from a STOP or HALT mode by means of 
an SMR. 


9.9 SPI Clock 


The SPI clock maybe driven by three sources: TimerO, a 
division of the internal system clock, or the external master 
when in slave mode. Bit D6 of the SCON Register controls 
what source drives the SPI clock. A O in bit D6 of the SCON 
Register determines the division of the internal system 
clock if this is used as the SPI clock source. Divide by 2, 4, 
8, or 16 is chosen as the scaler. 
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Standard Serial Setup 





(1) (2) (255) (256) 
Up to 256 slaves per SS line 


Three Wire Compare Setup 





Multiple slaves may have the same address. 


Figure 9-13. SPI System Configuration 
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9.10 Receive Character Available and 
Overrun 


When a complete data stream is received, an interrupt is 


generated and the RxCharAvail bit in the SCON Register 


is set. Bit 4 inthe SCON Register is for enabling or disabling 
the RxCharAvail interrupt. The RxCharAvail bit is available 
for interrupt polling purposes and is reset when the RxBUF 
Register is read. RxCharAvail is generated in both master 
and slave modes. While in slave mode, if the RxBUF is not 
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read before the next data stream is received and loaded 
into the RxBUF Register, Receive Character Overrun 
(RxCharOverrun) occurs. Since there is no need for clock 
control in slave mode, bit D1 in the SPI Control Register is 
used to log any RxCharOverrun (Figure 9-14 and Figure 
9-15). 


No Parameter Min Units 

1 DI to SK Setup 10 ns 

2 SK to DO Valid 15 ns 

3 SS to SK Setup 5 Tsk ns 

4 SS to DO Valid 15 ns 

5 SK to DI Hold Time 10 ns 
Tsk 


SK 


SS 


Ce 


DI 


St 
= 


Figure 9-14. SPI Timing 


SMR 


Bit Counter 
Anterrupt 
Control 


IRQ3 


SPI Compare Register (SCOMP) 













SPI Shift Register 


SPI Receive Buffer (RxBUF) 


SPI Control 


Figure 9-15. SPI Logic 







SK 
Port 
Control 
on ue 
SS 
SPI 
Clock 
TCLK SCLK +n 
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Open-Drain 
pete a a germ 
SPI EN P20 
[| 
P20 IN 
or 4 
SPI DI 2 
~ 
. A 2 <j | Auto Latch 
~ | 
R ae 500K Q 
Open-Drain 


p27 OUT ————slandard_, 


he 
SPI DO SPI y 
FAD 
P27 OE Standard = 
SPI Active ai [_} > 

SCON 


pba] —_] 9 $6100 Enatie 


4 P27 OUT 
*SPI must be enabled with DO. 
P27 IN << 


Figure 9-16. SPI Data In/Out Configuration 
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SK IN <j 
SPI EN > 
SPI MSTR > - : 
SPI EN 


SK OUT 
P34 OUT . MUX 


P31 


— 


REF 
ss 


| SPI EN * 
SPIMSTR > » 
a >> 








PCON 


PS « DO) a’ Pas Comparator Out 
1 P34, P35 Comparator Output 


Figure 9-17. SPI Clock / SPI Slave Select Output Configuration 
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10.1 INTRODUCTION 


The Z8® can be a microcontroller with 20 pins for external 
memory interfacing. The external memory interface on the 
Z8 is generally for either RAM or ROM. This is only available 
for devices featuring Port 0, Port 1, R/MW, /DM, /AS, and 

/DS. Please refer to specific product specifications for 
availability of these features. 


(Port 1)AD7-ADO 


(Port0) AD15-AD8 


Z8 
IAS 


DS | 





USER'S MANUAL 


EXTERNAL INTERFACE 


CHAPTER 10 1 





The Z8 has a multiplexed external memory interface. In the 
multiplexed mode, eight pins from Port 1 form an Address/ 
Data Bus (AD7-ADO), eight pins from Port 0 form a High 
Address Bus (A15-A8). Three additional pins provide the 
Address Strobe, Data Strobe, and the Read/Write Signal. 
Figure 10-1 shows the external interface pins of the Z8. 


External 
Progranv Data 


Memory up to 
64 Kbytes 
Each 


Figure 10-1. Z8 External Interface Pins 
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10.2 


PIN DESCRIPTIONS 


The following sections briefly describe the pins associated 
with the Z8® external memory interface. 


10.2.1 


10.2.2 


10.2.3 


10.2.4 


10.2.5 
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IAS Address Strobe (output, active Low). Address 
Strobe is pulsed Low once at the beginning of 
each machine cycle. The rising edge of /AS indi- 
cates the address, Read/Write (R//W), and Data 
Memory (/DM) signals are valid for program or 
data memory transfers. In some cases, the Z8 
address strobe is pulsed low regardless of ac- 
cessing external or internal memory. Please refer 
to specific product specifications for /AS opera- 
tion. 


IDS Data Strobe (output, active Low). Data Strobe 
provides the timing for data movement to or from 
the Address/Data bus for each external memory 
transfer. During a Write Cycle, data out is valid at 
the leading edge of the /DS. During a Read Cycle, 
data in must be valid prior to the trailing edge of the 
/DS. 


R//W Read/Write (output). Read/Write determines 
the direction of data transfer for memory transac- 
tions. R//W is Low when writing to program or data 
memory, and High for all other transactions. 


IDM Data Memory (output). Data Memory pro- 
vides a signal to separate External Program 
Memory from External Data Memory. It is a pro- 
grammable function on pin P34. Data memory is 
active low for External Data Memory accesses 
and high for External Program Memory accesses. 


P07 - P01 High Address Lines A15 -A8 (Outputs 
can be CMOS- or TTL- compatible. Please refer to 
product specifications for actual type). A15-A8 
provide the High Address lines for the memory 
interface. Port 0 - 1 mode register must have bits 
D7 = 1 and D1 = 1 toconfigure Port O as A15 - A8& 
(Figure 10-2). 


10.2.6 
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P17 - P10 Address/Data Lines AD7 - ADO (inputs/ 
outputs, TTL-compatible). AD7-ADO is a multi- 
plexed Address/Data memory interface. The lower 
eight Address lines (A7-AO) are multiplexed with 
Data lines (D7-D0O). Port 0 - 1 mode register must 
have bits D4 = 1 and D3 = 0 to configure Port 1 as 
AD7 - ADO (Figure 10-2). 


10.2.7 /RESET Reset (input, active Low). /RESET initial- 


10.2.8 


izes the Z8. When /RESET is deactivated, program 
execution begins from program location OOOCH. If 
held Low, /RESET acts as a register file protect 
during power-down and power-up sequences. To 
avoid asynchronous and noisy reset problems, 
the Z8 is equipped with areset filter of four external 
clocks (4T,C). If the external /RESET signal is less 
than 4T,C in duration, no reset will occur. On the 
fifth clock after the /RESET is detected, an internal 
reset signal is latched and held for an internal 
register count of 18 or more external clocks, or for 
the duration of the external /RESET, whichever is 
longer. Please refer to specific product specifica- 
tions for length of reset delay time. 


XTAL1, XTAL2. Crysta/1, Crystal2 (Oscillator in- 
put and output). These pins connect a parallel- 
resonant crystal, ceramic resonator, LC, RC net- 
work, or external single-phase clock to the on-chip 
oscillator input. Please refer to the device product 
specifications for information on availability of RC 
oscillator features. 
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10.3 EXTERNAL ADDRESSING CONFIGURATION 


The minimum bus configuration uses Port 1 as a multi- | PortOcanbe programmed to provide either four additional 

plexed address / data port (AD7-ADO), allowingaccessto address lines (A11- A8), which increases the addressable 

256 bytes of external memory. In this configuration, the |§ memory to4K bytes, or eight additional address lines (A15 

eight low order bits (AO - A7) are multiplexed with the data -A8), whichincreases the addressable external memory up 

(D7 - DO). to 64K bytes. It is required to add a NOP after configuring 
Port 0 / Port 1 for external addressing before jumping to 
external memory execution. 





Register F8H (PO1M) 
Port 0-1 Mode Register (PO1M) 
(Write-Only) 


[07] De] o9f D4 a Da] D1] bo 


~ L— o0,-Po, Mode 
00 Output 
01 = Input 


P,--P 
od’ Byte Output 
01 Byte Input 
10 AD -ADo 
11 High-Impédance 
A15 - A8 
AD7 - ADO 
/AS /DS 
R/W 


P07 - PO, Mode 
00 Output 

01 Input 

1X Ays- Ayo 


Figure 10-2. External Address Configuration 
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10.4 EXTERNAL STACKS 


The Z8® architecture supports stack operations in either the 
Z8 Standard Register File or External Data Memory. A 
stack’s location is determined by bit 2 in the Port 0-1 Mode 
Register (F8H). If bit 2 is set to 0, the stack is in External 
Data Memory. (Figure 10-3). 


The instruction used to change the stack selection bit 
should not be immediately followed by the instructions RET 


Register F8H (PO1M) 
Port 0-1 Mode Register 
(Write-Only) 
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or IRET, because this will cause indeterminate program 
flow. After a /RESET, the internal stack is selected. 


Please note that if PortO is configured as A15 - A8 and the 


stack is selected as internal, any stack operation will cause 
the contents in register FEH to be displayed on Port 0. 


D7 |De}05} 4] 09] pa} D1} Do 


~ Li soZ8 Stack Selection 


0 = External 
1 =Internal 


Figure 10-3. Z8 Stack Selection 


10.5 DATA MEMORY 


The two Z8 external memory spaces, data and program, 
are addressed as two separate spaces of up to 64 Kbytes 
each. External Program Memory and External Data Memory 
are logically selected by the Data Memory select output 
(/DM). /DM is made available on Port 3, bit 4 (P34) by 
setting bit 4 and bit 3 in the Port 3 Mode Register (F7H) to 
10 or 01 (Figure 10-4). /DM is active Low during the 


Register F7H (P3M) 
Port 3 Mode Register 
(Write-Only) 


76 Jos }4 fos [o2|1 Joo 


| ES etree 


execution of the LDE, LDEI instructions, and High for the 
execution of program instructions. /DM is also active Low 
during the execution of CALL, POP, PUSH, RET and IRET 
instructions if the stack resides in External Data Memory. 
After a /RESET, /DM is not selected. 


Bits Configuration 

00 P33= Input P34= Output 

01 P33= Input P34=/DM 

10 P33= Input P34=/DM 

11 P33= /DAV1 /RDY1 P34=RDY1//DAV1 


Figure 10-4. Port 3 Data Memory Operation 
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10.6 BUS OPERATION 


Typical data transfers between the Z8® and ExternalMemory _ scribe the basic timing periods of the Z8 are machine 

are illustrated in Figures 10-5 and 10-6. Machine cycles cycles (Mn), timing states (Tn), and clock periods. All 

can vary from six to 12 clock periods depending on the __ timing references are made with respect to the output 

operation being performed. The notations used to de- _ signals /AS and/DS. The clock is shown for clarity only and 
does not have a specific timing relationship with other 
signals. 


Machine Cycle 
oe | | LJ LE LILI LILI LILI 


A8-A15 





A15-A8 





AD7-ADO — 
ns, _ ———————a ——— ne 
RW ] a : \ 


[¢—————————--—— ‘Read Cycle ——-_—_>| 





Figure 10-5. External Instruction Fetch or Memory Read Cycle 


*Portinputs are strobed during T2, whichis two internal system clocks before the execution cycle of the current instruction. 
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Machine Cycle 


ok | | LEP LE LI LI LILI LILI 


A15-A8 


AD7-ADO A7-A0 3 


/AS 


R//W 


/DM 


A15-A8 
D7-D0 OUT 


LY I TF 
7 
—_—__ FX 


|<. Write Cycle —_____—___» 


Figure 10-6. External Memory Write Cycle 


10.6.1 Address Strobe (/AS) 


All transactions start with /AS driven Low and then raised 
High by the Z8®. The rising edge of /AS indicates that R//W, 
/DM (if used), and the address outputs are valid. The 
address outputs (AD7-ADO), remain valid only during MnT 1 
and typically need to belatched using /AS. Address outputs 
(A15-A8) remain stable throughout the machine cycle, 
regardless of the addressing mode. 
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10.6.2 Data Strobe (/DS) 


The Z8 uses /DS to time the actual data transfer. For Write 
operations (R//W = Low), a Low on/DS indicates that valid 
data is on the AD7-ADO lines. For Read operations (R/W = 
High), the bus is placed in a high-impedance state before 
driving /DS Low, so the addressed device can put its data 
on the bus. The Z8 samples this data prior to raising /DS 
High. 
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10.7 EXTENDED BUS TIMING 


Some products can accommodate slow memory access __ two clock periods. Figures 10-7 and 10-8 illustrate ex- 
time by automatically inserting an additional software tended external memory Read and Write cycles. 
controlled state time (Tx). This stretches the /DS timing by 


Machine Cycle 
1 
o« [| LE LI LI LILI LILI LI LI 
AD7-ADO (D7-Do iN) 
/AS \ / \ 
/DS Nf 
R/W / \ 


j«———__——_—_———_—————. Read Cycle —__________—_»| 


Figure 10-7. Extended External Instruction Fetch or Memory Read Cycle 


*Portinputs are strobed during T2, which is two internal system clocks before the execution cycle of the current instruction. 
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Machine Cycle 
ee ee 


A15-A8 A15-A8 
AD7-ADO A7-A0 D7-DO0 OUT | 


/DS Tf 
RW \ / 


{| <¢—_—_____—_——————. Write Cycle —_____—_—_——+| 


Figure 10-8. Extended External Memory Write Cycle 


Timing is extended by setting bit D5 in the Port 0-1 Mode Register (F8H) to 1 (Figure 10-9). After a /RESET, this bit is set 
to O. 


Register F8H (P01M) 
Port 0-1 Mode Register 
(Write-Only) 


[b7 [be fos p+ Joe |e fot Joo 


te a inal Memory Timing 


0 = Normal 
1 = Extended 


Figure 10-9. Extended Bus Timing 
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10.8 INSTRUCTION TIMING 


The High throughput of the Z8® is due , in part, to the use 
of an instruction pipeline, in which the instruction fetch and 
execution cycles are overlapped. During the execution of 
the current instruction, the opcode of the next instruction is 
fetched. Instruction pipelining is illustrated in Figure 10-10. 


Instruction Cycle Timing (One-Byte Instructions) 


Figure 10-11. 


j<————— Fetch 1st Byte. ——$______—_—_»>}j.q——___________-___—_ Fetch 1st Byte Of Next instruction 


* Port inputs are strobed during T2, which is two internal system clocks before the execution cycle of the 


current instruction. 





Clock 
A15-A8 
AD?-ADO 
iAS 

/0S 

RW 
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Figures 10-11 and 10-12 show typical instruction cycle 
timing for instructions fetched from memory. For those 
instructions that require execution time longer than that of 
the overlapped fetch, or reference program or datamemory 
as part of their execution, the pipe must be flushed. 


Note: Figures 10-11 and 10-12 assume the XTAL/2 clock mode 
is selected. 





10-9 


A ZILAS 


8 
S 





A15-A8 





/AS 


DS 


RW 


Fetch 3rd Byte (3-Byte Instr.) ——+| 
Fetch 1st Byte fl or byte Instr.) 


Fetch 2nd Byte 


Fetch 1st Byte 


Instruction Cycle Timing (Two and Three Byte Instructions) 


Figure 10-11. 
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* Port inputs are strobed during T2, which is two internal 
system clocks before the execution cycle of the current 
instruction. 
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10.9 Z8 RESET CONDITIONS 


After ahardware reset, extended timing is setto accommo- 
date slow memory access during the configuration routine, 
/DM is inactive, the stack resides in the register file. Port 0, 
1, and 2 are reset to input mode. Port 2 is set to Open-Drain 
Mode. 
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11.1 INTRODUCTION 
11.1.1 Z8 Addressing Modes 


The Z8® microcontroller provides six addressing modes: 


Register (R) 

Indirect Register (IR) 
Indexed (X) 

Direct (D) 

Relative (RA) 
Immediate (IM) 


With the exception of immediate data and condition codes, 
all operands are expressed as register file, Program 
Memory, or Data Memory addresses. Registers are ac- 
cessed using 8-bit addresses in the range of OOH-FFH. 
The Program Memory or Data Memory is accessed using 
16-bit addresses (register pairs) in the range of OQOOOH- 
FFFFH. 


USER'S MANUAL 


CHAPTER 11 
ADDRESSING MODES 


Working Registers are accessed using 4-bit addresses in 
the range of 0-15 (OH-FH). The address of the register 
being accessed is formed by the combination of the upper 
four bits in the Register Pointer (R253) and the 4-bit 
working register address supplied by the instruction. 


Registers can be used in pairs to designate 16-bit values 
or memory addresses. A Register Pair must be specified 
as an even-numbered address in the range of 0, 2, ...., 14 
for Working Registers, or 4, 6, ....238 for actual registers. 


In the following definitions of Z8 Addressing Modes, the 
use of ‘register’ can also imply register pair, working 
register, or working register pair, depending on the con- 
text. 


Note: See the product data sheet for exact program, data, and 
register memory types and address ranges available. 
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11.2 Z8 REGISTER ADDRESSING (R) 
In 8-bit Register Addressing mode, the operand value is _—_In the Register Addressing (Figure 11-1), the destination 


equivalent to the contents of the specified register or | and/or source address specified corresponds to the ac- 
register pair. tual register in the register file. 


Program Memory Register File 











8-Bit Register 
File Address 






Points to 






One Operand One Register 
Instruction in the 
(Example) nega! 

ile 






Figure 11-1. 8-Bit Register Addressing 


In 4-bit Register Addressing (Figure 11-2), the destination | address is combined with the upper four bits of the 
and/or source addresses point to the Working Register Register Pointer to form the actual 8-bit address of the 
within the current Working Register Group. This 4-bit affected register. 


Register File 


Points to 
Origin of 
Working 
Register 
Group 


Program Memory 


_ Operand 


4-Bit Working 
Registers " Operand 
Points to 
Two Operand the Working 
Instruction OpCode Registers 
(Example) | 


Figure 11-2. 4-Bit Register Addressing 
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11.3 Z8 INDIRECT REGISTER ADDRESSING (IR) 


In the Indirect Register Addressing Mode, the contents of | When accessing program memory or External Data 
the specified register are equivalent to the address of the | Memory, register pairs or Working Register pairs are used 
operand (Figures 11-3 and 11-4). to hold the 16-bit addresses. 


Depending upon the instruction selected, the specified 
register contents points to a Register, Program Memory, or 
an External Data Memory location. 


Program Memory Register File 














Address of Operand 
Used By Instruction 
8-Bit Register 
File Address ; 
Points to one 
One Operand Register in 
Instruction Register File 
(Example) 
Points to 
Register of 
Operand 


Value Used In 
Instruction 
Execution 


Figure 11-3. Indirect Register Addressing to Register File 
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11.3 Z8 INDIRECT REGISTER ADDRESSING (IR) (Continued) 


Register File 


jen to ee 
of Workin 
_ Program Memory Register Group 
Register 
Pair LSB 
4-Bit Working Register 
Register Address jdt Ez Points to ass MSB 
Instruction Example Regist 
egister 
References Either Cpeers Pair(Even 
a Hoh Memory or Address) 
ata Memory 16-Bit Address 
Points to Program 
Program or Data 
or Data Memory Memory 


Value Used In 
Instruction Operand 


Figure 11-4. Indirect Register Addressing to Program or Data Memory 
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11.4 Z8 INDEXED ADDRESSING (X) 


The Indexed Addressing Modeisusedonly bytheLoad(LD) address to obtain the address of the operand. Figure 11- 
instruction. An indexed address consists of a register ad- 4 illustrates this addressing convention. 


dress offset by the contents of a designated Working Reg- 
ister (the Index). This offset is added to the register 
Register File io 


Points to Origin 
of Working 
Register Group 


Program Memory 


| a Working 
Register 


Two Operand | dst/ 
instruction | 
OpCode +) | 
Addr Offset 


Value Used In 


Operand Instruction 


Figure 11-5. Indexed Register Addressing 
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11.5 Z8 DIRECT ADDRESSING (DA) 


The Direct Addressing mode, as shown in Figure 11-6, 
specifies the address of the next instruction to be ex- 
ecuted. Only the Conditional Jump (JP) and Call (CALL) 
instructions use this addressing mode. 


Program Memory 


Program Memory 
Address Used 


Lower Addr. Byte 


Upper Addr. Byte 


OpCode 





Figure 11-6. Direct Addressing 
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11.6 Z8 RELATIVE ADDRESSING (RA) 

In the Relative Addressing mode, illustrated in Figure 
11-7, the instruction specifies a two’s-complement signed 


displacement in the range of -128 to +127. This is added 
to the contents of the PC to obtain the address of the next 


Z8° MICROCONTROLLERS 


instruction to be executed. The PC (prior to the add) 
consists of the address of the instruction following the 
Jump Relative (JR) or Decrement and Jump if Non-Zero 
(DJNZ) instruction. JR and DJNZ are the only instructions 
which use this addressing mode. 


Program Memory 








JR or DJNZ 


Next OpCode 
Displacement 
OpCode 


Program Memory 
Address Used 









Current 
PC Value 







Figure 11-7. Relative Addressing 
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11.7 Z8 IMMEDIATE DATA ADDRESSING (IM) 


Immediate data is considered an “addressing mode” for as the source operand. The operand value used by the 
the purposes of this discussion. It is the only addressing __ instruction is the value supplied in the operand field itself. 
mode that does not indicate a register or memory address § Because an immediate operand is part of the instruction, 


itis always located in the Program Memory address space 
(Figure 11-8). 


Program Memory 


OpCode 


Immediate Data 





The Operand value 
is in the instruction 


Figure 11-8. Immediate Data Addressing 
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12.1 Z8 FUNCTIONAL SUMMARY 





Z8® instructions can be divided functionally into the follow- Table 12-3. Logical Instructions 
ing eight groups: : : 
Mnemonic Operands Instruction 
m Load AND dst, src ical AND 
m@ Bit Manipulation OM = caries 
m= Arithmetic CR dst, src LogicalOR 
Mm Block Transfer 
XOR dst, src LogicalExclusveOR 
m Logical RE ene ee eee ee Seen RE ee 
m Rotate and Shift 
m Program Control Table 12-4. Program Control Instructions 
m@ CPU Control : : 
Mnemonic Operands Instruction 
The following summary shows the instructions belonging to CAL dy CallProcedure 
each group and the number of operands required for each. DUN dst src DecrementandJump 
The source operand is 'src,' the destination operand is Non-Zero 
‘dst,'and a condition code is 'cc.' IRET InterruptRetum 
uP cc,dst Jump 
Table 12-1. Load Instructions R oc, dst JumpRelative 
Mnemonic Operands Instruction RET Retun 
QR cst Clear 
ID dst src Load Table 12-5. Bit Manipulation Instructions 
LDC dst,src LoadConsiant Mnemonic Operands _Instruction 
LDE dst, src LoadExtemal 
POP cst Pop TOM dst, src TestCamplement 
PUSH gc Push UnderMask 
™ dst, src TestUnderMask 
AND d BitCh 
Table 12-2. Arithmetic Instructions CR ee si 
Mnemonic Operands Instruction xR ds. sic BitComplement 
ADC dst, src Add with Carr ; 
ADD dst, src Add | y Table 12-6. Block Transfer Instructions 
CP dst, src Compare Mnemonic Operands _Instruction 
DA dst Decimal Adjust 
DEC dst Decrement LDC dst, src LoadConstant 
DECW dst Decrement Word Autolncrement 
INC dst Increment LDEI dst, src LoadExtemal 
INCW dst Increment Word Autolncrement 
SBC dst, src Subtract with Carry 
SUB dst, src Subtract 
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12.1 Z8FUNCTIONAL SUMMARY (Continued) 


Table 12-7. Rotate and Shift Instructions 


Mnemonic Operands _eInstruction 


RL dst Rotate Left 

RLC dst Rotate Left Through Carry 
RR dst Rotate Right 

RRC dst Rotate Right Through Carry 
SRA dst Shift Right Arithmetic 
SWAP dst Swap Nibbles 


12.2 PROCESSOR FLAGS 


The Flag Register (FCH) informs the user of the current 
status of the Z8. The flags and their bit positions in the Flag 
Register are shown in Figure 12-1. 


The Z8 Flag Register contains six bits of status information 
which are setor cleared by CPU operations. Four of the bits 
(C, V, Zand S) can be tested for use with conditional Jump 
instructions. Two flags (H and D) cannot be tested and are 
used for BCD arithmetic. The two remaining bits in the Flag 
Register (F1 and F2) are available to the user, but they 


Register FCH (Flags) 
Flag Register (Read/Write) 
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Table 12-8. CPU Control Instructions 


Mnemonic Operands Instruction 

CCF Complement Carry Flag 
DI Disable Interrupts 

El Enable Interrupts 

HALT Halt 

NOP No Operation 

RCF Reset Carry Flag 

SCF Set Carry Flag 

SRP sic Set Register Pointer 
STOP Stop 

WDH WDT Enable During HALT 
WDT WDT Enable or Refresh 


must be set or cleared by instructions and are not usable 
with conditional Jumps. 


As with bits in the other control registers, the Flag Register 
bits can be setor reset by instructions; however, only those 
instructions that do not affect the flags as an outcome of the 
execution should be used (Load Immediate). 


Note: The Watch-Dog Timer (WDT) instruction effects the Flags 
accordingly: Z=1, S=0, V=0. 


07 ps} os] v4] Da} 02} 01] bo) 


Fr 


User Flag (F1) 

User Flag (F2) 

Half Carry Flag (H) 
Decimal Adjust Flag (D) 
Overflow Flag (V) 

Sign Flag (S) 

Zero Flag (2) 

Carry Flag (C) 


Figure 12-1. Z8 Flag Register 
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12.2.1 Carry Flag (C) 


The Carry Flag is set to 1 whenever the result of an 
arithmetic operation generates a ‘carry out of' or a ‘borrow 
into' the high order bit 7. Otherwise, the Carry Flag is 
cleared to 0. 


Following Rotate and Shift instructions, the Carry Flag 
contains the last value shifted out of the specified register. 


Aninstruction can set, reset, or complement the Carry Flag. 


IRET changes the value of the Carry Flag when the Flag 
Register saved in the Stack is restored. 


12.2.2 Zero Flag (Z) 


For arithmetic and logical operations, the Zero Flag is setto 
1 if the result is zero. Otherwise, the Zero Flag is cleared 
to 0. 


If the result of testing bits in a register is OOH, the Zero Flag 
is set to 1. Otherwise the Zero Flag is cleared to 0. 


lf the result of a Rotate or Shift operation is OOH, the Zero 
Flag is set to 1. Otherwise, the Zero Flag is cleared to 0. 


IRET changes the value of the Zero Flag when the Flag 
Register saved in the Stack is restored. The WDT Instruc- 
tion sets the Zero Flag to a 1. 


12.2.3 Sign Flag (S) 


The Sign Flag stores the value of the most significant bit of 
a result following an arithmetic, logical, Rotate, or Shift 
operation. 


When performing arithmetic operations on signed num- 
bers, binary two’s-complement notation is used to repre- 
sent and process information. A positive number is identi- 
fied by a O in the most significant bit position (bit 7); 
therefore, the Sign Flag is also 0. 


Anegative number is identified by a 1 inthe most significant 
bit position (bit 7); therefore, the Sign Flag is also 1. 


IRET changes the value of the Sign Flag when the Flag 
Register saved in the Stack is restored. 
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12.2.4 Overflow Flag (V) 


For signed arithmetic, Rotate, and Shift operations, the 
Overflow Flag is set to 1 when the result is greater than the 
maximum possible number (>127) or less than the mini- 
mum possible number (<—128) that can be represented in 
two’s-complement form. The Overflow Flag is set to 0 if no 
overflow occurs. 


Following logical operations the Overflow Flag is set to O. 


IRET changes the value of the Overflow Flag when the Flag 
Register saved in the Stack is restored. 


12.2.5 Decimal Adjust Flag (D) 


The Decimal Adjust Flag is used for BCD arithmetic. Since 
the algorithm for correcting BCD operations is different for 
addition and subtraction, this flag specifies what type of 
instruction was last executed so that the subsequent Deci- 
mal Adjust (DA) operation can function properly. Normally, 
the Decimal Adjust Flag cannot be used as atest condition. 


After a subtraction, the Decimal Adjust Flag is set to 1. 
Following an addition it is cleared to 0. 


IRET changes the value of the Decimal Adjust Flag when 
the Flag Register saved in the Stack is restored. 


12.2.6 Half Carry Flag (H) 


The Half Carry Flag is set to 1 whenever an addition 
generates a “carry out of” bit 3 (Overflow) or a subtraction 
generates a “borrow into” bit 3. The Half Carry Flag is used 
by the Decimal Adjust (DA) instruction to convert the binary 
result of a previous addition or subtraction into the correct 
decimal (BCD) result. As in the case of the Decimal Adjust 
Flag, the user does not normally access this flag. 


IRET changes the value of the Half Carry Flag when the 
Flag Register saved in the Stack is restored. 


12-3 





A SiLAS Z8° MICROCONTROLLERS 
12.3 CONDITION CODES 


Condition codes and flag settings are summarized in Tables 
The C, Z, S, and V Flags control the operation of the 12-9, 12-10, and 12-11. Notation for the flags and how they 
‘Conditional’ Jump instructions. Sixteen frequently useful § are affected are as follows: 
functions of the flag settings are encoded in a 4-bit field 
called the condition code (cc), which forms bits 4-7 of the Table 12-10. Flag Settings Definitions 
conditional instructions. 


Symbol Definition 
Table 12-9. Z8 Flag Definitions 0 Cleared to 0 
Flag Description : Set to 1 | | 
Set or cleared according to operation 
C Carry Flag - Unaffected 
Z Zero Flag X Undefined 
S Sign Flag 
V Overflow Flag 
D Decimal Adjust Flag 
H Half Carry Flag 
Table 12-11. Condition Codes 
Binary Mnemonic Definition Flag Settings 
0000 F Always False - 
1000 (blank) Always True - 
0111 C Carry C= 1 
1111 NC No Carry C=0 
0110 Z Zero Z= 1 
1110 NZ Non-Zero Z=0 
1101 PL Plus S=0 
0101 MI Minus S = 1 
0100 OV Overflow V=1 
1100 NOV No Overflow V=0 
0110 EQ Equal Z= 1 
1110 NE Not Equal Z=0 
1001 GE Greater Than or Equal (S XOR V) = 0 
0001 LT Less Than (S XOR V) = 1 
1010 GT Greater Than (Z OR (S XOR V)) = O 
0010 LE Less Than or Equal (Z OR (S XOR V)) = 1 
1111 UGE Unsigned Greater Than or Equal C=0 
0111 ULT Unsigned Less Than C=1 
1011 UGT Unsigned Greater Than (C=OANDZ=0)=1 
0011 ULE Unsigned Less Than or Equal (C OR Z) = 1 
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12.4 NOTATION AND BINARY ENCODING 
In the detailed instruction descriptions that make up the 


rest of this chapter, operands and status flags are repre- 
sented by a notational shorthand. Operands, condition 


Table 12-12. Notational Shorthand 


Notation Address Mode Operand 
cc Condition Code 
r Working Register Rn 
R Register Reg 
or 
Working Register Rn 
RR Register Pair Reg 
or 
Working Register Pair RRp 
Ir Indirect Working Register @Rn 
IR Indirect Register @Reg 
or 
Indirect Working Register @Rn 
Irr Indirect Working Register Pair @RRp 
IRR Indirect Register Pair @Reg 
or 
Working Register Pair @RRp 
X Indexed Reg (Rn) 
DA Direct Address Addrs 
RA Relative Address Adadrs 
IM Immediate #Data 
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codes, address modes, and their notations are as follows 
(Table 12-12): 





Range * 
See condition codes 
n=Q0-15 


Reg. represents a number in the range of OOH to FFH 


n=0-15 


Reg. represents an even number in the range of OOH to 
FEH 


p =0, 2, 4, 6, 8, 10, 12, or 14 
n=0-15 


Reg. represents a number in the range of OOH to FFH 


n=0- 15 
p = 0, 2, 4, 6, 8, 10, 12, or 14 


Reg. represents an even number in the range OOH to 
FFH 


p =0, 2, 4, 6, 8, 10, 12, or 14 


Reg. represents a number in the range of OOH to FFH 
andn=0- 15 


Addrs. represents a number in the range of OOH to FFH 


Addrs. represents a number in the range of +127 to-128 
which is an offset relative to the address of the next 
instruction 


Data is a number between OOH to FFH 





* See the device product specification to determine the exact register file range available. The register file size varies by device type. 
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12.4 NOTATION AND BINARY ENCODING (Continued) 


Additional symbols used are: 


Table 12-13. Additional Symbols 


Symbol Definition 

dst Destination Operand 

strc Source Operand 

@ Indirect Address Prefix 

SP Stack Pointer 

PC Program Counter 

FLAGS Flag Register (FCH) 

RP Register Pointer (FDH) 

IMR Interrupt Mask Register (FBH) 
# Immediate Operand Prefix 
% Hexadecimal Number Prefix 
H Hexadecimal Number Suffix 
B Binary Number Suffix 

OPC Opcode 


Assignment of a value is indicated by the symbol “«-”. For 
example, 


dst — dst + src 
indicates the source data is added to the destination data 
and the result is stored in the destination location. The 
notation ‘addr(n)' is used to refer to bit 'n' of a given 
location. For example, 

dst (7) 


refers to bit 7 of the destination operand. 
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12.4.1 Assembly Language Syntax 


For proper instruction execution, Z8 assembly language 
syntax requires ‘dst, src' be specified, in that order. The 
following instruction descriptions show the format of the 
object code produced by the assembler. This binary format 
should be followed by users who prefer manual program 
coding or who intend to implement their own assembler. 


Example: if the contents of registers 43H and O8H are 
added and the result is stored in 43H, the assembly syntax 
and resulting object code is: 


ASM: ADD 43H, 08H 
OBJ: 04 08 43 


(ADD dst, src) 
(OPC src, dst) 


In general, whenever an instruction format requires an 
8-bit register address, that address can specify any register 
location in the range 0 - 255 or aWorking Register RO- R15. 
If, in the above example, register O8H is a Working Regis- 
ter, the assembly syntax and resulting object code would 
be: 


ASM: ADD 43H, R8 
OBJ: 04 E8 43 


(ADD dst, src) 
(OPC src, dst) 


Note: See the device product specification to determine the exact 
register file range available. The register file size varies by device 


type. 
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12.5 Z8 INSTRUCTION SUMMARY 


Instruction 


and Operation 


ADC dst, src 


dstedst + src +C 


ADD dst, src 


dstedst + src 


AND dst, src 


dste—dst AND src 


CALL dst 


SP<SP - 2 and 


PCedst or 
@SPe¢PC 


CCF 
CeNOT C 


CLR dst 
dst—0 


COM dst 


dste-NOT dst 


CP dst, src 
dst - src 


DA dst 
dst—DA dst 


DEC dst 
dstedst - 1 


DECW dst 
dstedst - 1 


DI 
IMR(7)<—0 


DJNZ 1, dst 
Ir - 1 

if r # 0, then 
PC<—PC + dst 
Range: +127, 
—128 


EI 
IMR(7)<—1 


HALT 


INC dst 
dstedst + 1 


Mode 
dst src 


Tt 


Tt 


DA 


IRR 


pe 


IR 


IR 


RR 
IR 


RA 


Address Opcode 
Byte (Hex) Affected 


if ] 


Of ] 


at ] 


D6 
D4 


40 
41 


00 
01 


80 
8 1 


8 F 


rA 
r=Q-F 


9 F 


7F 


r=0-F 
20 
2 1 


Flags 


CZ 


* 


*K 


*K 


S 
*K 


< 


instruction 
and Operation 


INCW dst 
dstedst + 1 


IRET 


FLAGS<@SP; 


SP<—SP + 1 
PC<—@SP; 


SPeSP + 2, and 


IMR(7)<1 


JP cc, dst 
if cc is true, 


then PCedst 


JR cc, dst 
if cc is true, then 


PC<—PC + dst 


Range: +127 to -128 


LD dst, src 
dstesrc 


LDC dst, src 
dstesrc 


LDCi dst, src 
dstesre and 
r—r +1 oF 
re—r+ 


LDE dst, src 
dstesrc 


LDEI dst, src 
dste-src and 
re r+l or 

fr —tr+1 


NOP 
OR dst, src 


dstedst OR src 


Address Opcode 


Mode 


dst src 


RR 
IR 


DA 


IRR 
RA 


=a oS = oe = = i 


a 


if 
Irr 


Irr 


Irr 


r 
Irr 


t 


irr 


Irr 


irr 


irr 
r 
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Byte (Hex) 


A0 - OF 


Al 


BF * Kk OK 


cD - - - 
c=0-F 
30 


cB 2 oe 8 
c=0-F 


rc - - - 
8 

r9 
r=0-F 
C7 
D7 

E 3 

F3 

E 4 

E5 

E 6 

E7 

F5 


C2 pe 
D2 


C3 ae 
D3 


92 


C2 a 
D2 
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12.5 INSTRUCTION SUMMARY (Continued) 


instruction 


and Operation 


SBC dst, src 


dste—dst - src - C 


SCF 
C1 


SRA dst 


Address Opcode 
Byte (Hex) Affected 
CZSVODH 


Mode 
dst src 


R 
IR 


IR 


50 
51 


70 
71 


CF 


AF 


C0 
C1 


3t ] 


DF 


D0 
D1 


31 


6 F 


Flags 
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Instruction Address Opcode Flags 
and Operation Mode Byte (Hex) Affected 
dst src CZS VODH 

SUB dst, src tT at | * KK *K 1 * 
dstedst - src 
SWAP dst R FO X * *& X - - 

cea | IR F1 
[7 4f3_ io 

ae 
TCM dst, src T 6{ ] - &**O - - 
(NOT dst) 
AND src 
TM dst, src Tt 7[ ] - &£x* 0 - - 
dst AND src 
WDH 4F - XX X - - 
WDT 5 F - X X X - - 
XOR dst, src Tt BE ] - ** 0 - - 
dst—dst 
XOR src 


t These instructions have an identical set of addressing modes, which are 
encoded for brevity. The first Opcode nibble is found in the instruction set 
table above. The second nibble is expressed symbolically by a'‘[ }'in this 
table, andits value is found in the following table to the left of the applicable 
addressing mode pair. 


For example, the Opcode of an ADC instruction using the addressing 
modes r (destination) and Ir (source) is 13. 





Address Mode Lower 
dst src Opcode Nibble 
r r [2] 

r Ir [3] 

R R [4] 

R IR [5] 

R IM (6) 

IR IM [7] 


smh. 
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12.5.1 OPCODE MAP 
Lower Nibble (Hex) 
0 1 2 7 


6.5 6.5 10.5 10.5} 105 | 105 6.5 6.5 
0 DEC Dee Pa ADD | ADD ; ADD | ADD | ADD LD LD 
R1 — a s ri, ir2 | R2, R14 IR2, Rif R1, 1M} IR1, IM} 11, R2 7 r2, R14 


6.5 10.5 | 10.5 10.5 

1 RLC nie ane apc | apc | apc | apc | apc 
R1 IR1 r1,r2 | rt, 'r2 | R2,R1} IR2,R1] R1, 1M } IR1, IM 

6.5 6.5 10.5 | 105 7 105 | 10.5 
BH RIEIEIE. 
R1 | IRV | rt,r2] 11,12] R2,R1] IR2, R1] R41, 1M | 1R1, IM 

8.0 6.1 6.5 10.5 | 10.5 | 10.5 

3 JP | SRP | SBC | sBcC | SBC | SBC /| SBC | SBC 
IRR1 | IM ri,r2 | 1, Ir2 | R2,R1] IR2,R1] R1,IM] 1R1, 1M 

8.5 8.5 6.5 10.5 | 105 10.5 

4 DA DA OR OR OR OR OR OR 
R1 IR1 | rt,r2 | rt, tr2 | R2,R1] IR2,R1} 1, 1M} IR1, IM} 

10.5 | 10.5 6.5 10.5 | 105 | 105 10.5 
SEAR AREA bE 
R1 IR1_ | rt,r2 | r1,tr2 | R2,R1] IR2,R1] R1, 1M] IR1, IM 

6.5 6.5 6.5 10.5 10.5 

6 com | COM rc tem | tom | tom | tom | Tom 
IR1 uh 2 R2,R1] IR2,R1} Ri, IM | IR1, IM 


* 
yo [reeleee| [8 | me || 
@ 7 | PUSH| PUSH ™ | ™ | T™ | TM 
2 R2 IR2 2 r2 | rt, 1r2 | R2,R1] IR2,R1] R41, IM | R41, IM 
> 105 | 105 | 120 | 18.0 Pt ft [| 
> 8 | DECW| DECW] LDE | LDEI 
Es RR1 | IR | rt tere | tet, tere 
6.5 6.5 | 120 | 18.0 
EEL 
R1 IR1 fr treet f tr2, Ir 
10.5 | 10.5 
A INCW | INCW 


ne i os 
cP cP 
RR1 a Hl 2 ri, Ir2 | R2,R1 es ie a i ai “ti 
as | aon on on | 2 
B CLR cn ae XOR | XOR | XOR| XOR | XOR 
R1 RL ri,r2 | r1,tr2 | R2,R1] IR2,R1} R1,1M] IR1, IM 
aka ts 
c RRC fac Lbc | LDcI 
R1 IR ri, Irr2 j iri, Irr2 r1,x,R2 


6.5 6.5 12.0 | 18.0 {| 20.0 20.0 te 5 
D SRA LDC | LDCI | CALL* ee 


Inet, r2 irri, lr2} IRR ao ie 


as 
RAR: 
E LD LD LD LD 
ie ri, IR2 7 R2,R1{1R2,R1} R1, IM} IR1, iM 
8.5 8.5 a 
ec it | 
iri, r2 R2, IR1 


2 3 
Bytes per Instruction 
Lower 
Opcode 
Nibble 
Execution | Pipeline 
Cycles Cycles 





Upper 
Opcode ———eA Mnemonic 
Nibble 
First Second 
Operand Operand 
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A D E F 


12/10.5]12/10.0] 6.5 12.10.0] 6.5 
DJNZ JR LD JP INC 
r1,RA |} cc,RAt ri, IM | cc, DA ri 


So 
Go 


Lo 
Qo 
a) 


> ~ 
ro 


m= o 2 
-—= 1. = 


2 3 1 
Legend: 
R = 8-bit Address 
r = 4-bit Address 
R1 or r1 = Dst Address 
R2 or r2 = Src Address 


Sequence: 
Opcode, First Operand, 
Second Operand 


Note: Blanks are reserved. 


*2-byte instruction appears as 
a 3-byte instruction 
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12.6 INSTRUCTION DESCRIPTIONS AND FORMATS 


ADC 
ADD WITH CARRY 
ADC 
Add with Carry 
ADC dst, src 


Instruction Format: 
OPC Address Mode 
Cycles (Hex) dst src 





6 12 r r 

2. tS 
10 14 R R 

10 16 R IM 

mits Le] 10 17 IR IM 


Operation: dst <— dst + src +C 


The source operand, along with the setting of the Carry (C) Flag, is added to the destination 
operand. Two's complement addition is performed. The sum is stored in the destination 
operand. The contents of the source operand are not affected. In multiple precision 
arithmetic, this instruction permits the carry from the addition of low order operands to be 
carried into the addition of high order operands. 


Set if there is a carry from the most significant bit of the result; cleared otherwise. 
Set if the result is zero; cleared otherwise. 

Set if the result is negative; cleared otherwise. 

Set if an arithmetic overflow occurs, thatis, if both operands are of the same sign and 
the result is of the opposite sign; cleared otherwise. 

Always cleared. 

Set if there is a carry from the most significant bit of the low order four bits of the result; 
cleared otherwise. 


Flags: 


LO <S<A8NO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B (EH) tothe high 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 
then ECH will be used as the destination operand in the OpCode. 


a 


Example: If Working Register R3 contains 16H, the C Flag is set to 1, and Working Register R11 
contains 20H, the statement: 


ADC R3, R11 
OpCode: 12 3B 


leaves the value 37H in Working Register R3. The C, Z, S, V, D, and H Flags are all cleared. 
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ADC 


Z8® MICROCONTROLLERS 


ADD WITH CARRY 


Example: 


Example: 


Example: 


Example: 


Example: 


lf Working Register R16 contains 16H, the C Flag is not set, Working Register R10 contains 
20H, and Register 20H contains 11H, the statement: 


ADC R16, @R10 
OpCode: 13 FA 


leaves the value 27H in Working Register R16. The C, Z, S, V, D, and H Flags are all cleared. 
lf Register 34H contains 2EH, the C Flag is set, and Register 12H contains 1BH, the 
statement: 


ADC 34H, 12H 
OpCode: 14 12 34 


leaves the value 4AH in Register 34H. The H Flag is set, and the C, Z, S, V, and D Flags are 
cleared. 

If Register 4BH contains 82H, the C Flag is set, Working Register R3 contains 10H, and 
Register 10H contains 01H, the statement: 


ADC 4BH, @R3 
OpCode: 15 E3 4B 


leaves the value 84H in Register 4BH. The S Flag is set, and the C, Z, V, D, and H Flags are 
cleared. 


lf Register 6CH contains 2AH, and the C Flag is not set, the statement: 


ADC 6CH, #03H 
OpCode: 16 6C 03 


leaves the value 2DH in Register 6CH. The C, Z, S, V, D, and H Flags are all cleared. 


lf Register D4H contains 5FH, Register 5FH contains 4CH, and the C Flag is set, the 
statement: 


ADC @D4hH, #02H 
OpCode: 17 D4 02 


leaves the value 4FH in Register 5FH. The C, Z, S, V, D, and H Flags are all cleared. 
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ADD 
Add 


ADD dst, src 


Z8® MICROCONTROLLERS 


instruction Format: 


Operation: 


Flags: 


Note: 


Example: 


Example: 
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OPC Address Mode 





Cycles (Hex) dst src 
6 02 r 
10 04 R R 
10 06 R IM 


dst <— dst +src 


The source operand is added to the destination operand. Two’s complement addition is 
performed. The sum is stored in the destination operand. The contents of the source operand 
are not affected. 


Set if there is a carry from the most significant bit of the result; cleared otherwise. 
Set if the result is zero; cleared otherwise. 

Set if the result is negative; cleared otherwise. 

Set if an arithmetic overflow occurs, that is, if both operands are of the same sign and 
the result is of the opposite sign; cleared otherwise. 

Always Cleared. 

Set if there is a carry from the most significant bit of the low order four bits of the result; 
cleared otherwise. 


IFO S8NO 


Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B(EH)tothehigh 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 
then ECH will be used as the destination operand in the OpCode. 


= 


If Working Register R3 contains 16H and Working Register R11 contains 20H, the statement: 


ADD R3, R11 
OpCode: 02 3B 


leaves the value 36H in Working Register R3. The C, Z, S, V, D, and H Flags are all cleared. 


If Working Register R16 contains 16H, Working Register R10 contains 20H, and Register 
20H contains 11H, the statement: 


ADD R16, @R10 
OpCode: 03 FA 


leaves the value 27H in Working Register R16. The C, Z, S, V, D, and H Flags are all cleared. 


A ZILOS 


ADD 
ADD 


Example: 


Example: 


Example: 


Example: 


Z8® MICROCONTROLLERS 


lf Register 34H contains 2EH and Register 12H contains 1BH, the statement: 


ADD 34H, 12H 

OpCode: 04 12 34 
leaves the value 49H in Register 34H. The H Flag is set, and the C, Z, S, V, and D Flags are i 
cleared. 





lf Register 4BH contains 82H, Working Register R3 contains 10H, and Register 10H contains 
O1H, the statement: 


ADD 3EH, @R3 
OpCode: 05 E3 4B 


leaves the value 83H in Register 4BH. The S Flag is set, and the C, Z, V, D, and H Flags are 
cleared. 


lf Register GCH contains 2AH, the statement: 


ADD 6CH, #03H 
OpCode: 06 6C 03 


leaves the value 2DH in Register 6CH. The C, Z, S, V, D, and H Flags are all cleared. 


lf Register D4H contains 5FH and Register 5FH contains 4CH, the statement: 


ADD @D4H, #02H 
OpCode: 07 D4 02 


leaves the value 4EH in Register 5FH. The C, Z, S, V, D, and H Flags are all cleared. 
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AND 
Logical AND 


AND dst, src 


Z8® MICROCONTROLLERS 


LOGICAL AND 


Instruction Format: 


Operation: 


Flags: 


Note: 


Example: 


Example: 
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OPC Address Mode 
Cycles (Hex) dst sic 


6 52 r r 
6 53 r Ir 





10 54 R R 
10 56 R IM 


dst <— dst AND src 


The source operand is logically ANDed with the destination operand. The AND operation 
results ina 1 being stored whenever the corresponding bits in the two operands are both 1, 
otherwise a 0 is stored. The result is stored in the destination operand. The contents of the 
source bit are not affected. 


Unaffected 

Set if the result is zero; cleared otherwise 

Set if the result of bit 7 is set; cleared otherwise 
Always reset to 0 

Unaffected 

Unaffected 


LFOSPNO 


Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B (EH) tothe high 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 
then ECH will be used as the destination operand in the OpCode. 


os 


If Working Register R1 contains 34H (0011 1000B) and Working Register R14 contains 4DH 
(10001101), the statement: 


AND R1, R14 
OpCode: 52 1E 


leaves the value 04H (00001000) in Working Register R1. The Z, V, and S Flags are cleared. 


If Working Register R4 contains F9H (11111001B), Working Register R13 contains 7BH, and 
Register 7BH contains 6AH (01101010B), the statement: 


AND R4, @R13 
OpCode: 53 4D 


leaves the value 68H (01 101000B) in Working Register R4. The Z, V, andS Flags are cleared. 


A ZILCS 
AND 
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LOGICAL AND 


Example: 


Example: 


Example: 


Example: 


If Register 3AH contains the value F5H (11110101B) and Register 42H contains the value 
OAH (00001010), the statement: 


AND 3AH, 42H 
OpCode: 54 42 3A 


leaves the value OOH (OOOQO000B) in Register 3AH. The Z Flag is set, and the V and S Flags 
are cleared. 


If Working Register R5 contains FOH (11110000B), Register 45H contains 3AH, and Register 
3AH contains 7FH (01111111B), the statement: 


AND R5, @45H 
OpCode: 55 45 E5 


leaves the value 70H (01 1 10000B) in Working Register R5. The Z, V, and S Flags are cleared. 


If Register 7AH contains the value F7H (11110111B), the statement: 


AND 7AH, #F0H 
OpCode: 56 7A FO 


leaves the value FOH (11110000B) in Register 7AH. The S Flag is set, and the Z and V Flags 
are cleared. 


If Working Register R3 contains the value 3EH and Register 3EH contains the value ECH 
(11101100B), the statement: 


AND @R3, #05H 
OpCode: 57 E3 05 


leaves the value 04H (00000100B) in Register 3EH. The Z, V, and S Flags are cleared. 
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CALL 
CALL PROCEDURE 


CALL 
Call Procedure 


CALL dst 


Instruction Format: 


OPC Address Mode 
Cycles (Hex) dst 


Operation: SP <— SP-2 
@SP <— PC 
PC <— dst 





The Stack pointer is decremented by two, the current contents of the Program Counter (PC) 
(address of the first instruction following the CALL instruction) are pushed onto the top of the 
Stack, and the specified destination address is then loaded into the PC. The PC now points 
to the first instruction of the procedure. 


At the end of the procedure a RET (return) instruction can be used to return to the original 
program flow. RET will pop the top of the Stack and replace the original value into the PC. 


Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


Flags: 


TFCOSONDO 


Note: Address mode IRR can be used to specify a 4-bit Working Register Pair. In this format, the 
destination Working Register Pair operand is specified by adding 1110B (EH) to the high 
nibble of the operand. For example, if Working Register Pair RR12 (CH) is the destination 
operand, then ECH will be used as the destination operand in the OpCode. 


Example: If the contents of the PC are 1A47H and the contents of the SP (Registers FEH and FFH) are 
3002H, the statement: 


CALL 3521H 
OpCode: D6 35 21 


causes the SP to be decremented to 3000H, 1A4AH (the address following the CALL 
instruction) to be stored in external data memory 3000 and 3001H, and the PC to be loaded 
with 3521H. Tne PC now points to the address of the first statement in the procedure to be 
executed. 
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CALL 
CALL PROCEDURE 
Example: If the contents of the PC are 1A47H, the contents of the SP (Register FFH) are 72H, the 


contents of Register A4H are 34H, and the contents of Register Pair 34H are 3521H, the 


statement: 
CALL @A4H 
OpCode: D4 A4 


causes the SP to be decremented to 70H, 1A4AH (the address following the CALL 
instruction) to be stored in R70H and 71H, and the PC to be loaded with 3521H. The PC now 
points to the address of the first statement in the procedure to be executed. 
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CCF 
COMPLEMENT CARRY FLAG 
CCF 
Complement Carry Flag 
CCF 


instruction Format: 
OPC 
Cycles (Hex) 





OPC 6 EF 


Operation: C <—NOTC 


The C Flag is complemented. If C = 1, then itis changed toC =0; or, if C =0, thenitis changed 

toC=1. 
Flags: Complemented 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


LOSONO 


Example: If the C Flag contains a 0, the statement: 


CCF 
OpCode: EF 


will change the C Flag from C =OtoC = 1. 
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CLR 
CLEAR 


CLR 
CLEAR 


CLR dst 


instruction Format: OPC Address Mode 


Cycles (Hex) dst 


6 Bi IR 


Operation: dst <— 0 








The destination operand is cleared to OOH. 


Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


Flags: 


LTOSAPNO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 


Example: If Working Register R6 contains AFH, the statement: 


CLR R6 
OpCode: BO E6 


will leave the value OOH in Working Register R6. 


lf Register ASH contains the value 23H, and Register 23H contains the value FCH, the 
statement: 


CLR @A5H 
OpCode: B1 A5 


will leave the value OOH in Register 23H. 
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COM 
COMPLEMENT 
COM 
Complement 
COM dst 


instruction Format: 


OPC Address Mode 
Cycles (Hex) dst 


6 61 IR 


Operation: dst <— NOT dst 





The contents of the destination operand are complemented (one’s complement). All 1 bits are 
changed to 0, and all 0 bits are changed to 1. 


Unaffected 

Set if the result is zero; cleared otherwise. 
Set if result bit 7 is set; cleared otherwise. 
Always reset to 0. 

Unaffected 

Unaffected 


Flags: 


LOSPNO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 


Example: If Register O8H contains 24H (00100100B), the statement: 


COM 08H 
OpCode: 60 08 


leaves the value DBH (11011011) in Register O8H. The S Flag is set, and the Z and V Flags 
are cleared. 


Example: If Register O8H contains 24H, and Register 24H contains FFH (11111111B), the statement: 


COM @08H 
OpCode: 61 08 


leaves the value OOH (QOOOO000B) in Register 24H. The Z Flag is set, and the V and S Flags 
are cleared. 
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CP 
COMPARE 
CP 
Compare 
CP dst, src 
Instruction Format: 1 
OPC Address Mode 
Cycles (Hex) dst src 
6 A2 r r 
10 A4 R R 
sli Le] 10 AS oR IR 
10 A6 R IM 
Operation: dst - src 
The source operand is compared to (subtracted from) the destination operand, and the 
appropriate flags are set accordingly. The contents of both operands are unaffected. 
Flags: C: Cleared if there is a carry from the most significant bit of the result. Set otherwise 
indicating a borrow. 
Z: Set if the result is Zero; cleared otherwise. 
S: Setif result bit 7 is set (negative); cleared otherwise. 
V: Set if arithmetic overflow occurs; cleared otherwise. 
D: Unaffected 
H: Unaffected 
Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B (EH) tothe high 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 
then ECH will be used as the destination operand in the OpCode. 
a 
Example: If Working Register R3 contains 16H and Working Register R11 contains 20H, the statement: 
CP R3, R11 
OpCode: A2 3B 
sets the C and S Flags, and the Z and V Flags are cleared. 
Example: lf Working Register R15 contains 16H, Working Register R10 contains 20H, and Register 
20H contains 11H, the statement: 
CP R16, @R10 


OpCode: A3 FA 
clears the C, Z, S, and V Flags. 
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Example: 


Example: 


Example: 


Example: 
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CP 
COMPARE 


If Register 34H contains 2EH and Register 12H contains 1BH, the statement: 


CP 34H,12H 
OpCode: A4 12 34 


clears the C, Z, S, and V Flags. 


If Register 4BH contains 82H, Working Register R3 contains 10H, and Register 10H contains 
O1H, the statement: 


CP 4BH, @R3 
OpCode: A5 E3 4B 


sets the S Flag, and clears the C, Z, and V Flags. 


If Register 6CH contains 2AH, the statement: 


CP 6CH, #2AH 
OpCode: A6 6C 2A 


sets the Z Flag, and the C, S, and V Flags are all cleared. 


If Register D4H contains FCH, and Register 5FH contains FCH, the statement: 


CP @D4H, 7FH 
OpCode: A7 D4 FF 


sets the V Flag, and the C, Z, and S Flags are all cleared. 
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DA 
DECIMAL ADJUST 


DA 
Decimal Adjust 


DA dst 


Instruction Format: 


OPC Address Mode 1 


Cycles (Hex) dst 


8 41 IR 


Operation: dst <— DA dst 








The destination operand is adjusted to form two 4-bit BCD digits following a binary addition 
or subtraction operation on BCD encoded bytes. For addition (ADD and ADC) or subtraction 
(SUB and SBC), the following table indicates the operation performed. 


Carry Bits 7-4 H Flag Bits 3-0 Number Carry 
Instruction Before Value Before Value Added To After 
DA (HEX) DA (HEX) Byte DA 

0 0-9 0 0-9 00 0 
0 0-8 0 A-F 06 0 
0 0-9 1 0-3 06 0 
ADD 0 A-F 0 0-9 60 1 
ADC 0 9-F 0 A-F 66 1 
0 A-F 1 0-3 66 1 
1 0-2 0 0-9 60 1 
1 0-2 0 A-F 66 1 
1 0-3 1 0-3 66 1 
0 0-9 0 0-9 00 0 
SUB 0 0-8 1 6-F FA 0 
SBC 1 7-F 0 0-9 AO 1 
1 6-F 1 6-F 9A 1 





If the destination operand is not the result of a valid addition or subtraction of BCD digits, the 
operation is undefined. 

Flags: Set if there is a carry from the most significant bit; cleared otherwise (see table above). 

Set if the result is Zero; cleared otherwise. 

Set if result bit 7 is set (negative); cleared otherwise. 

Undefined 

Unaffected 

Unaffected 


TOSPNO 


12-23 


Note: 


Example: 


Example: 
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DA 
DECIMAL ADJUST 


Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 


If addition is performed using the BCD value 15 and 27, the result should be 42. The sum is 
incorrect, however, when the binary representations are added in the destination location 
using standard binary arithmetic. 


0001 0101 = 15H 
+ Q010 O111 = 27H 
0011 1100 = 3CH 


If the result of the addition is stored in Register 5FH, the statement: 


DA 5FH 
OpCode: 40 5F 


adjusts this result so the correct BCD representation is obtained. 


0011 1100 = 3CH 
0000 0110 = O6H 
0100 0010 = 42H 


Register 5F now contains the value 42H. The C, Z, and S Flags are cleared, and V is undefined. 


If addition is performed using the BCD value 15 and 27, the result should be 42. The sum is 
incorrect, however, when the binary representations are added in the destination location 
using standard binary arithmetic. 


0001 0101 = 15H 
+ QO10 O111 = 27H 
0011 1100 = 3CH 


If Register 45F contains the value 5FH, and the result of the addition is stored in Register 5FH, 
the statement: 


DA @45H 
OpCode: 40 45 


adjusts this result so the correct BCD representation is obtained. 


0011 1100 = 3CH 
0000 O110 = O6H 
0100 0010 = 42H 


Register 5F now contains the value 42H. The C, Z, and S Flags are cleared, and V is 
undefined. 


A 2iltis Z8® MICROCONTROLLERS 


DEC 
DECREMENT 


DEC 
Decrement 


DEC dst 


Instruction Format: 





OPC Address Mode 
Cycles (Hex) dst 


6 01 IR 


Operation: dst <— dst - 1 





The contents of the destination operand are decremented by one. 


Unaffected 

Set if the result is zero; cleared otherwise 

Set if the result of bit 7 is set (negative); cleared otherwise 
Set if arithmetic overflow occurs; cleared otherwise 
Unaffected 

Unaffected 


Flags: 


TFOSPNO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 


Example: if Working Register R10 contains 2A%, the statement: 


DEC R10 
OpCode: 00 EA 


leaves the value 29H in Working Register R10. The Z, V, and S Flags are cleared. 


Example: lf Register BSH contains CBH, and Register CBH contains 01H, the statement: 


DEC @B3H 
OpCode: 01 B3 


leaves the value OOH in Register CBH. The Z Flag is set, and the V and S Flags are cleared. 


12-25 


A) eilLCis Z8° MICROCONTROLLERS 


DECW 
DECREMENT WORD 
DECW 
Decrement Word 
DECW dst 


Instruction Format: 
OPC Address Mode 
Cycles (Hex) dst 


10 80 RR 
iil 1081 IR 


Operation: dst <— dst - 1 





The contents of the destination (which must be an even address) operand are decremented 
by one. The destination operand can be a Register Pair or a Working Register Pair. 


Flags: C: Unaffected 
Z: Set if the result is zero; cleared otherwise 
S: Set if the result of bit 7 is set (negative); cleared otherwise 
V:  Setif arithmetic overflow occurs; cleared otherwise 
D: Unaffected 
H: Unaffected 
Note: Address modes RR or IRcan be used to specify a 4-bit Working Register Pair. In this format, 


the destination Working Register Pair operand is specified by adding 1110B (EH) to the high 
nibble of the operand. For example, if Working Register Pair R12 (CH) is the destination 
operand, then ECH will be used as the destination operand in the OpCode. 


Example: If Register Pair 30H and 31H contain the value OAF2H, the statement: 


DECW 30H 
OpCode: 80 30 


leaves the value OAF1H in Register Pair 30H and 31H. The Z, V, and S Flags are cleared. 


Example: lf Working Register RO contains 30H and Register Pairs 30H and 31H contain the value 
FAF3H, the statement: 


DECW @R0 
OpCode: 81 E0 


leaves the value FAF2H in Register Pair 30H and 31H. The S Flag is set, and the Z and V 
Flags are cleared. 
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DI 
DISABLE INTERRUPTS 


Di 
Disable Interrupts 


DI 
Instruction Format: 


OPC 
Cycles (Hex) 





OPC 6 8F 


Operation: IMR (7) <—0O 


Z8® MICROCONTROLLERS 





Bit 7 of Control Register FBH (the Interrupt Mask Register) is reset to 0. All interrupts are 
disabled, although they remain “potentially” enabled. (For instance, the Global Interrupt 


Enable is cleared, but not the individual interrupt level enables. ) 


Flags: C: Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


LOSON 


Example: If Control Register FBH contains 8AH (10001010) (interrupts IRQ1 and IRQ3 are enabled), 


the statement: 


sets Control Register FBH to OAH (00001010B) and disables these interrupts. 
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DJNZ 


Z8° MICROCONTROLLERS 


DJNZ 
DECREMENT AND JUMP IF NONZERO 


Decrement and Jump if Non-zero 


DJNZ r, dst 


instruction Format: 


Operation: 


Flags: 


Note: 


Example: 


OPC Address Mode 
Cycles (Hex) dst 


FAC | EC ee eee ee 
10 ifjumpnottaken (r=0 toF) 


r<—r-; 
lf r<> 0, PC <—PC + dst 


The specified Working Register being used as a counter is decremented. If the contents of 
the specified Working Register are not zero after decrementing, then the relative address is 
added to the Program Counter (PC) and control passes to the statement whose address is 
now in the PC. The range of the relative address is +127 to —-128. The original value of the 
PC is the address of the instruction byte following the DUNZ statement. When the specified 
Working Register counter reaches zero, control falls through to the statement following the 
DJNZ instruction. 


C: Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


LOSON 


The Working Register being used as a counter must be one of the Registers from 04H to EFH. 
Use of one of the I/O ports, control or peripheral registers will have undefined results. 


DJNZ is typically used to control a “loop” of instructions. In this example, 12 bytes are moved 
from one buffer area in the register file to another. The steps involved are: 

m Load 12 into the counter (Working Register R6). 

m Setup the loop to perform the moves. 

@ End the loop with DJUNZ. 


The assembly listing required for this routine is as follows: 


LD R6, 12 ‘Load Counter 
LOOP: LD R9, @R6 ‘Move one byte to 
LD @R6, R9 ‘new location 
DJNZ R6, LOOP = ;Decrement and Loop until 
‘counter = 0 
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EI 
ENABLE INTERRUPTS 


El 
Enable Interrupts 


Instruction Format: 1 
OPC 


Cycles (Hex) 





OPC 6 OF 


Operation: IMR (7) <—0 


Bit 7 of Control Register FBH (the Interrupt Mask Register) is set to 1. This allows potentially 
enabled interrupts to become enabled. 


Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


Flags: 


LOSONO 


Example: If Control Register FBH contains OAH (00001010) (interrupts IRQ1 and IRQS are selected), 
the statement: 


EI 
OpCode: 9F 


sets Control Register FBH to 8AH (10001010B) and enables IRQ1 and IRQ3. 
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HALT 
HALT 
HALT 
Halt 
HALT 


Instruction Format: 
OPC 
Cycles (Hex) 





OPC 6 7F 


Operation: The HALT instruction turns off the internal CPU clock, but not the XTAL oscillation. The 
counter/timers and the external interrupts IRQ1, IRQ2, and IRQ3 remain active. The devices 
are recovered by interrupts, either externally or internally generated. 


Flags: C: Unaffected 
Z: Unaffected 
S: Unaffected 
V: Unaffected 
D: Unaffected 
H: Unaffected 
Note: In order to enter HALT mode, it is necessary to first flush the instruction pipeline to avoid 
suspending execution in mid-instruction. The user must execute a NOP immediately before 
the execution of the HALT instruction. 
Example: Assuming the Z8 is in normal operation, the statements: 
NOP 
HALT 


OpCodes: FF 7F 
place the Z8 into HALT mode. 
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INC 
INCREMENT 


INC 
Increment 


INC dst 


instruction Format: 





OPC Address Mode 
Cycles (Hex) dst 


PIE 3 
6 20 R 


Operation: dst <— dst + 1 





The contents of the destination operand are incremented by one. 


Unaffected 

Set if the result is zero; cleared otherwise. 

Set if the result of bit 7 is set (negative); cleared otherwise. 
Set if arithmetic overflow occurs; cleared otherwise. 
Unaffected 

Unaffected 


Flags: 


LFOSPNO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 


Example: If Working Register R10 contains 2AH, the statement: 


INC R10 
OpCode: AE 


leaves the value 2BH in Working Register R10. The Z, V, and S Flags are cleared. 


Example: If Register BSH contains CBH, the statement: 


’ INC B3H 
OpCode: 20 B3 


leaves the value CCH in Register CBH. The S Flag is set, and the Z and V Flags are cleared. 


Example: If Register BSH contains CBH and Register BCH contains FFH, the statement: 


INC @B3H 
OpCode: 21 B3 


leaves the value OOH in Register CBH. The Z Flag is set, and the V and S Flags are cleared. 
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INCW 
INCREMENT WORD 
INCW 
Increment Word 
INCW dst 


Instruction Format: 
OPC Address Mode 
Cycles (Hex) dst 


10 Al IR 


Operation: dst <— dst - 1 





The contents of the destination (which must be an even address) operand is decremented 
by one. The destination operand can be a Register Pair or a Working Register Pair. 


Unaffected 

Set if the result is zero; cleared otherwise. 

Set if the result of bit 7 is set (negative); cleared otherwise. 
Set if arithmetic overflow occurs; cleared otherwise. 
Unaffected 

Unaffected 


Flags: 


LOSPNO 


Note: Address modes RR or IR can be used to specify a 4-bit Working Register Pair. In this format, 
the destination Working Register Pair operand is specified by adding 1110B (EH) to the high 
nibble of the operand. For example, if Working Register Pair R12 (CH) is the destination 
operand, then ECH will be used as the destination operand in the OpCode. 


Example: If Register Pairs 30H and 31H contain the value OAF2H, the statement: 


INCW 30H 
OpCode: AO 30 


leaves the value OAFS3H in Register Pair 30H and 31H. The Z, V, and S Flags are cleared. 


Example: If Working Register RO contains 30H, and Register Pairs 30H and 31H contain the value 
FAF3H, the statement: 


INCW @RO 
OpCode: Ai E0 


leaves the value FAF4H in Register Pair 30H and 31H. The S Flag is set, and the Z and V 
Flags are cleared. 
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IRET 


INTERRUPT RETURN 


IRET 


Interrupt RETURN 


IRET 


Instruction Format: 


Operation: 


OPC 
Cycles (Hex) 


OPC 16 BF 


FLAGS <— @SP 
SP <— SP + 1 
PC <— @SP 
SP <— SP + 2 
IMR (7) <— 1 


Z8® MICROCONTROLLERS 


This instruction is issued atthe end of an interruptservice routine. It restores the Flag Register 
(Control Register FCH) and the PC. It also re-enables any interrupts that are potentially 


enabled. 


Flags: C: 


ITOSO@N 


Restored to original setting before the interrupt occurred. 
Restored to original setting before the interrupt occurred. 
Restored to original setting before the interrupt occurred. 
Restored to original setting before the interrupt occurred. 
Restored to original setting before the interrupt occurred. 
Restored to original setting before the interrupt occurred. 


Example: 


If Stack Pointer Low Register FFH currently contains the value 45H, Register 45H contains 
the value OOH, Register 46H contains 6FH, and Register 47 Contains E4H, the statement: 


IRET 
OpCode: BF 


restores the FLAG Register FCH with the value OOH, restores the PC with the value 6FE4H, 
re-enables the interrupts, and sets the Stack Pointer Low to 48H. The next instruction to be 


executed will be at location 6FE4H. 
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JP 
JUMP 
JP 
JUMP 
JP cc, dst 


Instruction Format: . 
OPC Address Mode 





Cycles (Hex) dst 
Fee | ope 12 if jump taken ccD DA 
10 if not taken cc=O0toF 
Operation: If cc (condition code) is true, then PC <— dst 


A conditional jump transfers Program Control to the destination address if the condition 
specified by cc (condition code) is true. Otherwise, the instruction following the JP instruction 
is executed. See Section 12.3 for a list of condition codes. 


The unconditional jump simply replaces the contents of the Program Counter with the 
contents of the register pair specified by the destination operand. Program Control then 
passes to the instruction addressed by the PC. 


Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


Flags: 


LOSAPNO 


Note: Address mode IRR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 


Example: If the Carry Flag is set, the statement: 


JP C, 1520H 
OpCode: 7D 15 20 


replaces the contents of the Program Counter with 1520H and transfers program contro! to 
that location. If the Carry Flag had not been set, control would have fallen through to the 
statement following the JP instruction. 


Example: lf Working Register Pair RR2 contains the value 3F45H, the statement: 


JP @RR2 
OpCode: 30 E2 


replaces the contents of the PC with the value 3F45H and transfers program control to that 
location. 
iii mma aa einen 
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JR 


28° MICROCONTROLLERS 


JUMP RELATIVE 


JR 


Jump Relative 


JR cc, dst 


Instruction Format: 


Operation: 


Flags: 


Example: 


Example: 





OPC Address Mode 
Cycles (Hex) dst 


| co. | dst | 10 if jump taken ccB RA 
12 ifjumpnottaken cc=0 toF 
If cc is true, PC <— PC + dst 


Ifthe condition specified by the “cc’ is true, the relative address is added to the PC and control 
passes to the instruction located at the address specified by the PC (See Section 12.3 fora 
list of condition codes). Otherwise, the instruction following the JR instruction is executed. 
The range of the relative address is +127 to —128, and the original value of the PC is taken 
to be the address of the first instruction byte following the JR instruction. 


C: Unaffected 


Z: Unaffected 
S: Unaffected 
V: Unaffected 
D: Unaffected 
H: Unaffected 


If the result of the last arithmetic operation executed is negative, the next four statements 
(which occupy a total of seven bytes) are skipped with the statement: 


JR Mi, #9 
OpCode: 5B 09 


If the result was not negative, execution would have continued with the instruction following 
the JR instruction. 


A short form of a jump —45 is: 


JR #-45 
OpCode: 8B D3 


The condition code is “blank” in this case, and is assumed to be “always true.” 
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LD 
Load 


LD dst, sre 


instruction Format: 


[= Joro] Ls] 

Loo C= IL#_] 
Loe }L«# IL] 
Leo JL JL] 
Lore | ole] Ls] 


* In this instance, only a full 8-bit register can be used. 


Operation: dst <— src 


OPC 


Cycles (Hex) 


6 
6 


10 
10 


10 
10 


10 


10 


10 


rc 
r3 


ro 
r=OtoF 


E3 
F3 


E4 
E5 


E6 
E7 


F5 


C7 


D7 


Z8° MICROCONTROLLERS 


LD 
LOAD 





Address Mode 
dst src 
r IM 
r R 
R* r 
r Ir 
Ir r 
R R 
R IR 
R IM 
IR IM 
IR R 
r X 
X r 


The contents of the source operand are loaded into the destination operand. The contents 


of the source operand are not affected. 


Flags: C Unaffected 
Zz: Unaffected 
3: Unaffected 
V: Unaffected 
D Unaffected 


Unaffected 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B (EH) tothe high 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 


then ECH will be used as the destination operand in the OpCode. 


ee 
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LD 
LOAD 


Example: The statement: 


LD R15, #34H 
OpCode: FC 34 


loads the value 34H into Working Register R15. i 


Example: If Register 34H contains the value FCH, the statement: 


LD R14, 34H 
OpCode: F8 34 


loads the value FCH into Working Register R15. The contents of Register 34H are not 
affected. 





Example: lf Working Register R14 contains the value 45H, the statement: 


LD 34H, R14 
OpCode: E9 34 


loads the value 45H into Register 34H. The contents of Working Register R14 are not 
affected. 

Example: If Working Register R12 contains the value 34H, and Register 34H contains the value FFH, 
the statement: 


LD R13, @R12 
OpCode: E3 DC 


loads the value FFH into Working Register R13. The contents of Working Register R12 and 
Register R34 are not affected. 


Example: If Working Register R13 contains the value 45H, and Working Register R12 contains the 
value OOH the statement: 


LD @R13, R12 
OpCode: F3 DC 


loads the value OOH into Register 45H. The contents of Working Register R12 and Working 
Register R13 are not affected. 


Example: lf Register 45H contains the value CFH, the statement: 


LD 34H, 45H 
OpCode: E4 45 34 


loads the value CFH into Register 34H. The contents of Register 45H are not affected. 
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Example: 


Example: 


Example: 


Example: 


Example: 


Example: 
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LD 
LOAD 


If Register 45H contains the value CFH and Register CFH contains the value FFH, the 
statement: 


LD 34H, @45H 
OpCode: E5 45 34 


loads the value FFH into Register 34H. The contents of Register 45H and Register CFH are 
not affected. 


The statement: 


LD 34H, #A4H 
OpCode: E6 34 A4 


loads the value A4H into Register 34H. 


If Working Register R14 contains the value 7FH, the statement: 


LD @R14, #FCH 
OpCode: E7 EE FC 


loads the value FCH into Register 7FH. The contents of Working Register R14 are not 
affected. 


If Register 34H contains the value CFH and Register 45H contains the value FFH, the 
statement: 


LD @34H, 45H 
OpCode: F5 45 34 


loads the value FFH into Register CFH. The contents of Register 34H and Register 45H are 
not affected. 


If Working Register RO contains the value 08H and Register 2CH (24H + 08H = 2CH) contains 
the value 4FH, the statement: 


LD R10, 24H(RO) 
OpCode: C7 AO 24 


loads Working Register R10 with the value 4FH. The contents of Working Register RO and 
Register 2CH are not affected. 


lf Working Register RO contains the value OBH and Working Register R10 contains 83H the 
statement: 


LD FOH(RO), R10 
OpCode: D7 AO FO 


loads the value 83H into Register FBH (FOH + OBH = FBH). Since this is the Interrupt Mask 
Register, the LOAD statement has the effect of enabling IRQ0 and IRQ1. The contents of 
Working Registers RO and R10 are unaffected by the load. 


A ZILA 


LDC 


Z8® MICROCONTROLLERS 


LOAD CONSTANT 


LDC 


Load Constant 


LDC dst, src 


Instruction Format: 


Operation: 


Flags: 


Example: 


Example: 


OPC Address Mode 





Cycles (Hex) src dst 
OPC 12 D2 Irr r 


dst <— src 


This instruction is used to load a byte constant from program memory into a Working Register, 
or vice versa. The address of the program memory location is specified by a Working Register 
Pair. The contents of the source operand are not affected. 


C: Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


ITOSON 


If Working Register Pair R6 and R7 contain the value 30A2H and program memory location 
30A2H contains the value 22H, the statement: 


LDC R2, @RR6 
OpCode: C2 26 


loads the value 22H into Working Register R2. The value of program memory location 30A2H 
is unchanged by the load. 

lf Working Register R2 contains the value 22H, and Working Register Pair R6 and R7 
contains the value 10A2H, the statement: 


LDC @RR6, R2 
OpCode: D2 26 


loads the value 22H into program memory location 10A2H. The value of Working Register 
R2 is unchanged by the load. 


Note: This instruction format is valid only for MCUs which can address external program memory. 
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LDCI 
LOAD CONSTANT AUTO-INCREMENT 


LDCI 
Load Constant Auto-increment 


LDCI dst, src 
instruction Format: 


OPC Address Mode 





Cycles (Hex) src dst 
18 C3 Ir Irr 
OPC 18 D3 rr Ir 


Operation: dst <— src 
r<—r+ 
r<—rir+ 1 


This instruction is used for block transfers of data between program memory and the Register 
File. The address of the program memory location is specified by a Working Register Pair, 
and the address of the Register File location is specified by Working Register. The contents 
of the source location are loaded into the destination location. Both addresses in the Working 
Registers are then incremented automatically. The contents of the source operand are not 


affected. 
Flags: C: Unaffected 
Z: Unaffected 
S: Unaffected 
V: Unaffected 
D: Unaffected 
H: Unaffected 
Example: If Working Register Pair R6-R7 contains 30A2H, program memory location 30A2H and 
30A3H contain 22H and BCH respectively, and Working Register R2 contains 20H, the 
statement: 


LDCI @R2, @RR6 
OpCode: C3 26 


loads the value 22H into Register 20H. Working Register Pair RR6 is incremented to 30A3H 
and Working Register R2 is incremented to 21H. A second 


LDCI @R2, @RRG6 
OpCode: C3 26 


loads the value BCH into Register 21H. Working Register Pair RR6 is incremented to 30A4H 
and Working Register R2 is incremented to 22H. 


Note: This instruction format is valid only for MCUs which can address external program memory. 
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LDCI 
LOAD CONSTANT AUTO-INCREMENT 


Example: If Working Register R2 contains 20H, Register 20H contains 22H, Register 21H contains 
BCH, and Working Register Pair R6-R7 contains 30A2H, the statement: 


LDCI @RR6, @R2 
OpCode: D3 26 


loads the value 22H into program memory location 30A2H. Working Register R2 is 
incremented to 21H and Working Register Pair R6-R7 is incremented to 30A3H. A second 


LDC!I @RR6, @R2 
OpCode: D3 26 


loads the value BCH into program memory location 30A3H. Working Register R2 is 
incremented to 22H and Working Register Pair R6-R7 is incremented to 30A4H. 
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LDE 
LOAD EXTERNAL DATA 


LDE 
Load External Data 


LDE dst, src 
Instruction Format: 


OPC Address Mode 





Cycles (Hex) sic dst 
12 82 r irr 
OPC 12 92 irr r 
Operation: dst <— src 


This instruction is used to load a byte from external data memory into a Working Register or 
vice versa. The address of the external data memory location is specified by a Working 
Register Pair. The contents of the source operand are not affected. 


Flags: C: Unaffected 
Z: Unaffected 
S: Unaffected 
V: Unaffected 
D: Unaffected 
H: Unaffected 

' Example: If Working Register Pair R6 and R7 contain the value 40A2H and external data memory 

location 40A2H contains the value 22H, the statement: 


LDE R2, @RR6 
OpCode: 82 26 


loads the value 22H into Working Register R2. The value of external data memory location 
40A2H is unchanged by the load. 


Example: If Working Register Pair R6 and R7 contain the value 404AH and Working Register R2 
contains the value 22H, the statement: 


LDE @RR6, R2 
OpCode: 92 26 


loads the value 22H into external data memory location 404AH 


Note: This instruction format is valid only for MCUs which can address external data memory. 
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LDEI 
LOAD EXTERNAL DATA AUTO-INCREMENT 


LDEI 
Load External Data Auto-increment 





LDE! dst, sre 


instruction Format: 1 


OPC Address Mode 








Cycles (Hex) src dst 
OPC 18 = 83 Ir Irr 
OPC 18 93 irr Ir 
Operation: dst <— src 
r<—r+ 
nr<—rn+1 


This instruction is used for block transfers of data between external data memory and the 
Register File. The address of the external data memory location is specified by a Working 
Register Pair, and the address of the Register File location is specified by a Working Register. 
The contents of the source location are loaded into the destination location. Both addresses 
in the Working Registers are then incremented automatically. The contents of the source are 


not affected. 
Flags: C: Unaffected 
Z: — Unaffected 
S: Unaffected 
V: Unaffected 
D: Unaffected 
H: Unaffected 
Example: If Working Register Pair R6 and R7 contains 404AH, external data memory location 404AH 
and 404BH contain ABH and C3H respectively, and Working Register R2 contains 22H, the 
statement: 


LDE! @R2, @RRG6 
OpCode: 83 26 


loads the value ABH into Register 22H. Working Register Pair RR6 is incremented to 404BH 
and Working Register R2 is incremented to 23H. A second 


LDCI @R2, @RRG 
OpCode: 83 26 


loads the value C3H into Register 23H. Working Register Pair RR6 is incremented to 404CH 
and Working Register R2 is incremented to 24H. 
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LDEI 
LOAD EXTERNAL DATA AUTO-INCREMENT 


Example: lf Working Register R2 contains 22H, Register 22H contains ABH, Register 23H contains 
C3H, and Working Register Pair R6 and R7 contains 404AH, the statement: 


LDEI @RR6, @R2 
OpCode: 93 26 


loads the value ABH into external data memory location 404AH. Working Register R2 is 
incremented to 23H and Working Register Pair RR6 is incremented to 404BH. A second 


LDCI @RR6G, @R2 
OpCode: 93 26 


loads the value C3H into external data memory location 404BH. Working Register R2 is 
incremented to 24H and Working Register Pair RR6 is incremented to 404CH. 


Note: This instruction format is valid only for MCUs which can address external data memory. 
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NOP 
NO OPERATION 


NOP 
No Operation 


NOP 


instruction Format: 1 
OPC 


Cycles (Hex) 





OPC 6 FF 


Operation: No action is performed by this instruction. ltis typically used for timing delays or clearing the 
pipeline. 


Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


Flags: 


LFOSPNO 
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OR 
LOGICAL OR 


OR 
Logical OR 


OR dst, src 
Instruction Format: 


OPC Address Mode 
Cycles (Hex) dst src 





| 6 42 r r 

. a 6 4 
10 44 R R 

cals Ls] i006 45 CORR 
10 46 R IM 

= [es Go f & f 


Operation: dst <— dst OR src 


The source operand is logically ORed with the destination operand and the result is stored 
in the destination operand. The contents of the source operand are not affected. The OR 
operation results in a one bit being stored whenever either of the corresponding bits in the 
two operands is a one. Otherwise, a zero bit is stored. 


Unaffected 

Set if the result is zero; cleared otherwise 

Set if the result of bit 7 is set; cleared otherwise 
Always reset to O 

Unaffected 

Unaffected 


Flags: 


LFOSPNO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B(EH) tothe high 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 
then ECH will be used as the destination operand in the OpCode. 


= 


Example: lf Working Register R1 contains 34H (0011 1000B) and Working Register R14 contains 4DH 
(10001101), the statement: 


OR R11, R14 
OpCode: 42 1E 


leaves the value BDH (10111101B) in Working Register R1. The S Flag is set, and the Z and 
V Flags are cleared. 


Example: If Working Register R4 contains F9H (11111001B), Working Register R13 contains 7BH, and 
Register 7B contains GAH (01101010B), the statement: 


OR R4, @R13 
OpCode: 43 4D 


leaves the value FBH (11111011B) in Working Register R4. The S Flag is set, and the Z and 
V Flags are cleared. 
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OR 


LOGICAL OR 
Example: lf Register 3AH contains the value F5H (11110101B) and Register 42H contains the value 
OAH (00001010), the statement: 


OR 3AH, 42H 
OpCode: 44 42 3A 


leaves the value FFH (11111111B) in Register 3AH. The S Flag is set, and the Z and V Flags 
are cleared. 





Example: If Working Register R5 contains 70H (01 110000B), Register 45H contains 3AH, and Register 
3AH contains 7FH (01111111B), the statement: 


OR R5, @45H 
OpCode: 45 45 E5 


leaves the value 7FH (01111111B) in Working Register R5. The Z, V, and S Flags are 
cleared. 


Example: lf Register 7AH contains the value F3H (11110111B), the statement: 


OR 7AH, #FOH 
OpCode: 46 7A FO 


leaves the value F3H (11110111B) in Register 7AH. The S Flag is set, and the Z and V Flags 
are Cleared. 


Example: If Working Register R3 contains the value 3EH and Register 3EH contains the value OCH 
(000011008), the statement: 


OR @R3, #05H 
OpCode: 57 E3 05 


leaves the value ODH (00001101B) in Register 3EH. The Z, V, and S Flags are cleared. 
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POP 
POP 





POP 
Pop 
POP dst 
Instruction Format: OPC Address Mode 
Cycles (Hex) dst 
Operation: dst <— @SP 
SP <— SP + 1 
The contents of the location specified by the SP (Stack Pointer) are loaded into the 
destination operand. The SP is then incremented automatically. 
Flags: C: Unaffected 
Z: Unaffected 
S: Unaffected 
V: Unaffected 
D: Unaffected 
H: Unaffected 
Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 
Example: If the SP (Control Registers FEH and FFH) contains the value 70H and Register 70H contains 
44H, the statement: 
POP 34H 
OpCode: 50 34 
loads the value 44H into Register 34H. After the POP operation, the SP contains 71H. The 
contents of Register 70 are not affected. 
Example: If the SP (Control Registers FEH and FFH) contains the value 1000H, external data memory 
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location 1000H contains 55H, and Working Register R6 contains 22H, the statement: 


POP @R6 
OpCode: 51 E6 


loads the value 55H into Register 22H. After the POP operation, the SP contains 1001H. The 
contents of Working Register R6 are not affected. 
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PUSH 
PUSH 


PUSH 
Push 


PUSH sre 1 
Instruction Format: 


OPC Address Mode 








Cycles (Hex) dst 
10 Internal Stack 70 R 
oy [x | 12 External Stack 
12 Internal Stack 71 IR 


14 €xternal Stack 


Operation: SP <— SP-1 
@SP <— src 


The contents of the SP (stack pointer) are decremented by one, then the contents of the 
source operand are loaded into the location addressed by the decremented SP, thus adding 
a new element to the stack. 


Flags: C: Unaffected 
Z: Unaffected 
S: Unaffected 
V: Unaffected 
D: Unaffected 
H: 
Unaffected 
Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 
Example: If the SP contains 1001H, the statement: 
PUSH FCH 
OpCode: 70 FC 
stores the contents of Register FCH (the Flag Register) in location 1000H. After the PUSH 
operation, the SP contains 1000H. 
Example: lf the SP contains 61H and Working Register R4 contains FCH, the statement: 


PUSH @R4 
OpCode: 71 E4 


stores the contents of Register FCH (the Flag Register) in location 60H. After the PUSH 
operation, the SP contains 60H. 
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RCF 
RESET CARRY FLAG 
RCF 
Reset Carry Flag 
RCF 
Instruction Format: OPC 


Cycles (Hex) 





OPC 6 CF 


Operation: C<—0O 
The C Flag is reset to 0, regardless of its previous value. 


Reset to 0 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


Flags: 


TFOSONO 


Example: If the C Flag is currently set, the statement: 


RCF 
OpCode: CF 


resets the Carry Flag to O. 
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RET 
RETURN 


RET 
Return 


RET 


Instruction Format: oo 


OPC 
Cycles (Hex) 








OPC 14 AF 


Operation: PC <— @SP 
SP <— SP + 2 


This instruction is normally used to return from a procedure entered by a CALL instruction. 
The contents of the location addressed by the SP are popped into the PC. The next statement 
executed is the one addressed by the new contents of the PC. The stack pointer is also 
incremented by two. 


Flags: C: Unaffected 
Z: Unaffected 
S: | Unaffected 
V: Unaffected 
D: Unaffected 
H: Unaffected 
Note: Each PUSH instruction executed within the subroutine should be countered with a POP 


instruction in order to guarantee the SP is at the correct location when the RET instruction 
is executed. Otherwise the wrong address will be loaded into the PC and the program will not 
operate as desired. 


Example: If SP contains 2000H, external data memory location 2000H contains 18H, and location 
2001H contains B5H, the statement: 


RET 
OpCode: AF 


leaves the value 2002H in the SP, and the PC contains 18B5H, the address of the next 
instruction to be executed. 
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RL 
ROTATE LEFT 
RL 
Rotate Left 
RL dst 
Instruction Format: OPC Address Mode 


Cycles (Hex) dst 


6 91 IR 





Operation: C <—dst(7) 
dst(0) <— dst(7) 
dst(1) <— dst(0) 
dst(2) <— dst(1) 
dst(3) <— dst(2) 
dst(4) <— dst(3) 
dst(5) <— dst(4) 
dst(6) <— dst(5) 
dst(7) <— dst(6) 


The contents of the destination operand are rotated left by one bit position. The initial value 
of bit 7 is moved to the bit 0 position and also into the Carry Flag. 


Forfex] 


Flags: Set if the bit rotated from the most significant bit position was 1 (i.e., bit 7 was 1). 
Set if the result is zero; cleared otherwise. 

Set if the result in bit 7 is set; cleared otherwise. 

Set if arithmetic overflow occurred (if the sign of the destination operand changed 
during rotation); cleared otherwise. 

Unaffected 


Unaffected 


IQ S@NO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 
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RL 
ROTATE LEFT 
Example: lf the contents of Register C6H are 88H (10001000B), the statement: 
RL C6H 
OpCode: 80 C6 
leaves the value 11H (00010001B) in Register C6H. The C and V Flags are set, and the S 
and Z Flags are cleared. 
Example: If the contents of Register C6H are 88H, and the contents of Register 88H are 44H 
(01000100B), the statement: 
RL @C6H 


OpCode: 81 C6 


leaves the value 88H in Register 88H (10001000B). The S and V Flags are set, and the C 
and Z Flags are cleared. 
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RLC 
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RLC 
ROTATE LEFT THROUGH CARRY 


Rotate Left Through Carry 


RLC dst 


Instruction Format: 


OPC Address Mode 
Cycles (Hex) dst 





6 10 R 
ail 6 1 IR 


Operation: C <— dst(7) 
dst(0) <—C 
dst(1) <— dst(0) 
dst(2) <— dst(1) 
dst(3) <— dst(2) 
dst(4) <— dst(3) 
dst(5) <— dst(4) 
dst(6) <— dst(5) 
dst(7) <— dst(6) 


The contents of the destination operand along with the C Flag are rotated left by one bit 
position. The initial value of bit 7 replaces the C Flag and the initial value of the C Flag replaces 


bit O. 


Flags: 


C 
£: 
S: 
V: 
D 
H 


Wee ecco 


Set if the bit rotated from the most significant bit position was 1 (i.e., bit 7 was 1). 
Set if the result is zero; cleared otherwise. 

Set if the result bit 7 is set; cleared otherwise. 

Set if arithmetic overflow occurred (if the sign of the destination operand changed 
during rotation); cleared otherwise. 

Unaffected 

Unaffected 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 
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RLC 
ROTATE LEFT THROUGH CARRY 


Example: If the C Flag is reset and Register C6 contains 8F (10001111B), the statement: 
RLC C6 





OpCode: 10 C6 
leaves Register C6 with the value 1EH (00011110B). The C and V Flags are set, and S and 
Z Flags are cleared. 


Example: lf the C Flag is reset, Working Register R4 contains C6H, and Register C6 contains 8F 
(10001111B), the statement: 


RLC @R4 
OpCode: 11 E4 


leaves Register C6 with the value 1EH (000111108). The C and V Flags are set, and S and 
Z Flags are cleared. 
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RR 
ROTATE RIGHT 
RR 
Rotate Right 
RR dst 
Instruction Format: OPC Address Mode 


Cycles (Hex) dst 


6 EO R 





Operation: C <— dst(0) 
dst(0) <— dst(1) 
dst(1) <— dst(2) 
dst(2) <— dst(3) 
dst(3) <— dst(4) 
dst(4) <— dst(5) 
dst(5) <— dst(6) 
dst(6) <— dst(7) 
dst(7) <— dst(0) 


The contents of the destination operand are rotated to the right by one bit position. The initial 
value of bit 0 is moved to bit 7 and also into the C Flag. 


foro ooo] 


Flags: C Set if the bit rotated from the least significant bit position was 1 (i.e., bit O was 1). 

Z Set if the result is zero; cleared otherwise. 

S: Set if the result bit 7 is set; cleared otherwise. 

V: Set if arithmetic overflow occurred (if the sign of the destination operand changed 
during rotation); cleared otherwise. 

D Unaffected 

H 


Unaffected 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 


Le [os 
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RR 





ROTATE RIGHT 
Example: If the contents of Working Register R6 are 31H (001100018B), the statement: 
RR R6 
OpCode: EO E6 
leaves the value 98H (1001 1000) in Working Register R6. The C, V, and S Flags are set, and 
the Z Flag is cleared. 
Example: If the contents of Register C6 are 31H and the contents of Register 31H are 7EH 
(01111110B), the statement: 
RR @C6 


OpCode: E1 C6 
leaves the value 4FH (00111111) in Register 31H. The C, Z, V, and S Flags are cleared. 
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RRC 
ROTATE RIGHT THROUGH CARRY 


RRC 
Rotate Right Through Carry 


RRC dst 


instruction Format: OPC Address Mode 
Cycles (Hex) dst 


6 C1 IR 





Operation: C <— dst(0) 
dst(0) <— dst(1) 
dst(1) <— dst(2) 
dst(2) <— dst(3) 
dst(3) <— dst(4) 
dst(4) <— dst(5) 
dst(5) <— dst(6) 
dst(6) <— dst(7) 
dst(7) <—C 


The contents of the destination operand with the C Flag are rotated right by one bit position. 
The initial value of bit O replaces the C Flag and the initial value of the C Flag replaces bit 7. 


foros m[eefooo[ e+ 


Flags: Set if the bit rotated from the least significant bit position was 1 (i.e., bit O was 1). 
Set if the result is zero; cleared otherwise. 

Set if the result bit 7 is set; cleared otherwise. 

Set if arithmetic overflow occurred (if the sign of the destination operand changed 
during rotation); cleared otherwise. 

Unaffected 


Unaffected 


-O SANO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 
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RRC 
ROTATE RIGHT THROUGH CARRY 


Example: If the contents of Register C6H are DDH (11011101B) and the C Flag is reset, the statement: 
RRC C6H 


OpCode: CO C6 
leaves the value GEH (01101110B) in register C6H. The C and V Flags are set, and the Z and 
S Flags are cleared. 


Example: If the contents of Register 2C are EDH, the contents of Register EDH is OOH (OOO000008B), 
and the C Flag is reset, the statement: 


RRC @2CH 
OpCode: Ci 2C 


leaves the value 01H (000000018B) in Register EDH. The C, Z, S, and V Flags are reset. 
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SBC 
SUBTRACT WITH CARRY 
SBC 
Subtract With Carry 
SBC dst, sre 


Instruction Format: 
OPC Address Mode 
Cycles (Hex) dst sic 





6 32 r r 
ene 6 33 root 
10 34 R R 
sik Ls | 0 35 R IR 
10 36 R IM 
= Ls] 10 «37. IRM 


Operation: dst <— dst-src-C 


The source operand, along with the setting of the C Flag, is subtracted from the destination 
operand and the result is stored in the destination operand. The contents of the source 
operand are not affected. Subtraction is performed by adding the two's complement of the 
source operand to the destination operand. In multiple precision arithmetic, this instruction 
permits the carry (borrow) from the subtraction of low order operands to be subtracted from 
the subtraction of high order operands. 


© 


Cleared if there is a carry from the most significant bit of the result; set otherwise, 
indicating a “borrow.” 

Set if the result is 0; cleared otherwise. 

Set if arithmetic overflow occurred (if the operands were of opposite sign and the sign 
of the result is the same as the sign of the source); reset otherwise. 

Set if the result is negative; cleared otherwise. 

Cleared if there is a carry from the most significant bit of the low order four bits of the 
result; set otherwise indicating a “borrow.” 

Always set to 1. 


Flags: 


GO Ft” SN 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B (EH) tothehigh 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 
then ECH will be used as the destination operand in the OpCode. 


Example: If Working Register R3 contains 16H, the C Flag is set to 1, and Working Register R11 
contains 20H, the statement: 


SBC R3, R11 
OpCode: 32 3B 


leaves the value F5H in Working Register R3. The C, S, and D Flags are set, and the Z, V, 
and H Flags are all cleared. 
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SBC 


Z8® MICROCONTROLLERS 


SUBTRACT WITH CARRY 


Example: 


Example: 


Example: 


Example: 


Example: 


If Working Register R15 contains 16H, the C Flag is not set, Working Register R10 contains 
20H, and Register 20H contains 11H, the statement: 


SBC R16, @R10 
OpCode: 33 FA 


leaves the value O5H in Working Register R15. The D Flag is set, and the C, Z, S, V, and H 
Flags are cleared. 

lf Register 34H contains 2EH, the C Flag is set, and Register 12H contains 1BH, the 
statement: 


SBC 34H, 12H 
OpCode: 34 12 34 


leaves the value 13H in Register 34H. The D Flag is set, and the C, Z, S, V, and H Flags are 
cleared. 

lf Register 4BH contains 82H, the C Flag is set, Working Register R3 contains 10H, and 
Register 10H contains 01H, the statement: 


SBC 4BH, @R3 
OpCode: 35 E3 4B 


leaves the value 80H in Register 4BH. The D Flag is set, and the C, Z, S, V, and H Flags are 
cleared. 


lf Register 6CH contains 2AH, and the C Flag is not set, the statement: 


SBC 6CH, #03H 
OpCode: 36 6C 03 


leaves the value 27H in Register 6CH. The D Flag is set, and the C, Z, S, V, and H Flags are 
cleared. 


If Register D4H contains 5FH, Register 5FH contains 4CH, and the C Flag is set, the 


_ statement: 


SBC @D4H, #02H 
OpCode: 37 D4 02 


leaves the value 4AH in Register 5FH. The D Flag is set, and the C, Z, S, V, and H Flags are 
Cleared. 
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SCF 
SET CARRY FLAG 


SCF 
Set Carry Flag 


SRC 


Instruction Format: 
OPC 
Cycles (Hex) 





OPC 6 DF 


Operation: C<—1 
The C Flag is set to 1, regardless of its previous value. 


Set to 1 

Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


Flags: 


LOSeMNO 


Example: If the C Flag is currently reset, the statement: 


SCF 
OpCode: DF 


sets the Carry Flag to 1. 
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SRA 
SHIFT RIGHT ARITHMETIC 


SRA 
Shift Right Arithmetic 


SRA dst 
Instruction Format: i 
OPC Address Mode 


Cycles (Hex) dst 


6 D1 IR 


Operation: C <— dst(0) 
dst(0) <— dst(1) 
dst(1) <— dst(2) 
dst(2) <— dst(3) 
dst(3) <— dst(4) 
dst(4) <— dst(5) 
dst(5) <— dst(6) 
dst(6) <— dst(7) 
dst(7) <— dst(7) 








An arithmetic shift right by one bit position is performed on the destination operand. Bit O 
replaces the C Flag. Bit 7 (the Sign bit) is unchanged and its value is shifted into bit 6. 


= 
[7] p6] 0s] 04]03}02] 01} 00 


Set if the bit rotated from the least significant bit position was 1 (i.e., bit O was 1). 
Set if the result is zero; cleared otherwise. 

Set if the result bit 7 is set; cleared otherwise. 

Always reset to 0. 

Unaffected 

Unaffected 


Flags: 


TFOSONO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 





12-63 


A Silas 28° MICROCONTROLLERS 


SRA 
SHIFT RIGHT ARITHMETIC 


Example: If the contents of Working Register R6 are 31H (00110001B), the statement: 


SRA R6 
OpCode: DO E6 


leaves the value 98H (00011000) in Working Register R6. The C Flag is set, and the Z, V, 
and S Flags are cleared. 

Example: If Register C6 contains the value DFH, and Register DFH contains the value BBH (101 1 1000B), 
the statement: 


SRA @C6 
OpCode: D1 C6 


leaves the value DCH (11011100B) in Register DFH. The C, Z, and V Flags are reset, and 
the S Flag is set. 
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SRP 


Z8® MICROCONTROLLERS 


SET REGISTER POINTER 


SRP 


Set Register Pointer 


SRP src 


Instruction Format: 


Operation: 


OPC Address Mode 


Cycles (Hex) dst 





IM 


o 
Go 
— 


RP <— src 


The specified value is loaded into the Register Pointer (RP) (Control Register FDH). Bits 
7-4 determine the Working Register Group within the Z8 Standard Register File. These 
Working Registers are selected when bits 3-0 are set to OOOOB. When bits 3-0 are defined, 
the Expanded Working Register Bank is specified. The contents of bits 7-4 are disregarded 
when bits 3-0 are defined other than OOOOB. 








Register Pointer Working Actual 
(FDH) Register Group Registers 

Contents (Bin) (Hex) (Hex) 
1117 0000 F FO-FF 
1110 0000 E EO-EF 
1101 0000 D DO-DF 
1100 0000 C CO-CF 
1017 0000 B BO-BF 
1010 0000 A AO-AF 
1001 0000 9 90-9F 
1000 0000 8 80-8F 
0111 0000 7 70-7F 
0110 0000 6 60-6F 
0101 0000 5 50-5F 
0100 0000 4 40-4F 
0011 0000 3 30-3F 
0010 0000 2 20-2F 
0001 0000 1 10-1F 
0000 0000 0 00-0F 
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Note: 


Example: 


LOSONO 


Register Pointer 


(FDH) 


Contents (Hex) 


Xxxx 1111 
XxXxx 1110 
XxXxx 1101 
xxxx 1100 
Xxxx 1011 
XXxx 1010 
xXxxx 1001 
xXxxx 1000 
Xxxx 0111 
Xxxx 0110 
Xxxx 0101 
xxxx 0100 
XXxx 0011 
Xxxx 0010 
xxxx 0001 


Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 
Unaffected 


Working 


Register Group 


(Hex) 
F 


—| MP] wd] AL OT OIL NI wo] ol P| wl O| GO| Mm 


S 
SET REGISTER POINTER 


Working 
Registers 
(Dec) 


RO-R15 
RO-R15 
RO-R15 
RO-R15 
RO-R15 
RO-R15 
RO-R15 
RO-Ri5 
RO-R15 
RO-R15 
RO-R15 
RO-R15 
RO-R15 
RO-R15 
RO-R15 


Z8° MICROCONTROLLERS 


RP 


When an Expanded Register Bank is defined as the current Working Register, access to the 


Z8 Standard Register File is possible through direct addressing. 


The statement: 


SRP FOH 
OpCode: 70 FO 


sets the Register Pointer to access Working Register Group F in the Z8 Standard Register 
File. All references to Working Registers now affect this group of 16 registers. Registers FOH 


to FFH can be accessed as Working Registers RO to R15 
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SRP 
SET REGISTER POINTER 


Example: The statement: 


SRP OFH 
OpCode: 70 OF 


sets the Register Pointer to access Expanded Register Bank F as the current Working 
Registers. All references to Working Registers now affect this group of 16 registers. These 
registers are now accessed as Working Registers RO to R15. 





Example: Assume the RP currently addresses the Control and Peripheral Working Register Group and 
the program has just entered an interrupt service routine. The statement: 


SRP 70H 
OpCode: 31 70 


retains the contents of the Control and Peripheral Registers by setting the RP to 70H 
(01110000B). Any reference to Working Registers in the interrupt routine will point to 
registers 70H to 7FH. 
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STOP 
Stop 


STOP 


Instruction Format: 
OPC 


Cycles (Hex) 





OPC 6 6F 


Z8® MICROCONTROLLERS 


STOP 
STOP 


Operation: This instruction turns off the internal system clock (SCLK) and external crystal (XTAL) 
oscillation, and reduces the standby current. The STOP mode is terminated by a RESET 


which causes the processor to restart the application program at address OOOCH. 


Flags: C: Unaffected 
Z: Unaffected 
S: Unaffected 
V: Unaffected 
D: Unaffected 
H: Unaffected 
Note: In order to enter STOP mode, it is necessary to first flush the instruction pipeline to avoid 
suspending execution in mid-instruction. The user must execute a NOP immediately before 
the execution of the STOP instruction. 
Example: The statements: 


place the Z8 into STOP mode. 
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& 2iLdS 
SUB 


Z8® MICROCONTROLLERS 


SUBTRACT 


SUB 
Subtract 


SUB dst, src 


Instruction Format: 


Operation: 


Flags: 


| Note: 


Example: 


OPC Address Mode 
Cycles (Hex) dst src 


6 22 r r 
ihe 6 23 rot 





10 24 R R 
lke 10 2 R IR 
10 26 R IM 
tie Li] 10 27 IRM 


dst <— dst- src 


The source operand is subtracted from the destination operand and the resultis stored in the 
destination operand. The contents of the source operand are not affected. Subtraction is 
performed by adding the two’s complement of the source operand to the destination operand. 


Cleared if there is a carry from the most significant bit of the result; set otherwise, 
indicating a “borrow." 

Set if the result is 0; cleared otherwise. 

Set if arithmetic overflow occurred (if the operands were of opposite sign and the sign 
of the result is the same as the sign of the source); reset otherwise. 

Set if the result is negative; cleared otherwise. 

Cleared if there is a carry from the most significant bit of the low order four bits of the 
result; set otherwise indicating a “borrow." 

Always set to 1. 


9 20° SN © 


Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B (EH) tothehigh 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 
then ECH will be used as the destination operand in the OpCode. 


- 


lf Working Register R3 contains 16H, and Working Register R11 contains 20H, the 
statement: 


SUB R3, R11 
OpCode: 22 3B 


leaves the value F6H in Working Register R3. The C, S, and D Flags are set, and the Z, V, 
and H Flags are cleared. 
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SUB 
SUBTRACT 


Example: lf Working Register R15 contains 16H, Working Register R10 contains 20H, and Register 
20H contains 11H, the statement: 


SUB R16, @R10 
OpCode: 23 FA 


leaves the value O5H in Working Register R15. The D Flag is set, and the C, Z, S, V, and H 
Flags are cleared. 
Example: lf Register 34H contains 2EH, and Register 12H contains 1BH, the statement: 


SUB 34H, 12H 
OpCode: 24 12 34 


leaves the value 13H in Register 34H. The D Flag is set, and the C, Z, S, V, and H Flags are 
cleared. 

Example: lf Register 4BH contains 82H, Working Register R3 contains 10H, and Register 10H contains 
01H, the statement: 


SUB 4BH, @R3 
OpCode: 25 E3 4B 


leaves the value 81H in Register 4BH. The D Flag is set, and the C, Z, S, V, and H Flags are 
cleared. 


Example: lf Register 6CH contains 2AH, the statement: 


SUB 6CH, #03H 
OpCode: 26 6C 03 


leaves the value 27H in Register 6CH. The D Flag is set, and the C, Z, S, V, and H Flags are 
cleared. 


Example: If Register D4H contains 5FH, Register 5FH contains 4CH, the statement: 


SUB @D4hH, #02H 
OpCode: 17 D4 02 


leaves the value 4AH in Register 5FH. The D Flag is set, and the C, Z, S, V, and H Flags are 
cleared. 
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SWAP 
SWAP NIBBLES 


SWAP 
Swap Nibbles 


SWAP dst 


Instruction Format: i 
OPC Address Mode 


Cycles (Hex) dst 


6 Fi IR 


Operation: dst(7-4) <—> dst(3-0) 





The contents of the lower four bits and upper four bits of the destination operand are swapped. 


Unaffected 

Set if the result is zero; cleared otherwise. 
Set if the result bit 7 is set; cleared otherwise. 
Undefined 

Unaffected 

Unaffected 


Flags: 


TFOSPNO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, 
destination Working Register operand is specified by adding 1110B (EH) to the high nibble 
of the operand. For example, if Working Register R12 (CH) is the destination operand, then 
ECH will be used as the destination operand in the OpCode. 


Example: If Register BCH contains B3H (10110011B), the statement: 


SWAP B3H 
OpCode: FO B3 


will leave the value 3BH (00111011B) in Register BCH. The Z and S Flags are cleared. 


Example: If Working Register R5 contains BCH and Register BCH contains B3H (10110011B), the 
statement: 


SWAP @R5H 
OpCode: F1 E5 


will leave the value 3BH (00111011B) in Register BCH. The Z and S Flags are cleared. 
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TCM 
TEST COMPLEMENT UNDER MASK 
TCM 
Test Complement Under Mask 


TCM dst, src 


Instruction Format: OPC Address Mode 





Cycles (Hex) dst src 
6 62 r r 
sae ast sche 6 63 r Ir 


10 64 R R 
10 66 R IM 
Ore ei 10 67 IR IM 


Operation: (NOT dst) AND src 


This instruction tests selected bits in the destination operand for a logical 1 value. The bits 
to be tested are specified by setting a 1 bit in the corresponding bit position in the source 
operand (the mask). The TCM instruction complements the destination operand, and then 
ANDs itwith the source mask (operand). The Zero (Z) Flag can then be checked to determine 
the result. If the Z Flag is set, then the tested bits were 1. When the TCM operation is 
complete, the destination and source operands still contain their original values. 


Unaffected 

Set if the result is zero; cleared otherwise. 
Set if the result bit 7 is set; cleared otherwise. 
Always reset to 0. 

Unaffected 

Unaffected 


Flags: 


ITO<SYNO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B(EH) tothe high 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 
then ECH will be used as the destination operand in the OpCode. 


eb] « ET] 


Example: If Working Register R3 contains 45H (01000101B) and Working Register R7 contains the 
value 01H (000000018) (bit 0 is being tested if it is 1), the statement: 


TCM R3, R7 
OpCode: 62 37 


will set the Z Flag indicating bit 0 in the destination operand is 1. The V and S Flags are 
cleared. 
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TEST COMPLEMENT UNDER MASK 


Example: 


Example: 


Example: 


Example: 


Example: 


lf Working Register R14 contains the value F3H (11110011B), Working Register R5 contains 
CBH, and Register CBH contains 88H (10001000B) (bit 7 and bit 4 are being tested if they 
are 1), the statement: 


TCM R14, @R5 
OpCode: 63 E5 


will reset the Z Flag, because bit 4 in the destination operand is not a 1. The V and S Flags 
are also cleared. 

lf Register D4H contains the value 04H (000001000B), and Working Register RO contains 
the value 80H (100000008B) (bit 7 is being tested if itis 1), the statement: 


TCM D4H, RO 
OpCode: 64 EO D4 


will reset the Z Flag, because bit 7 in the destination operand is not a 1. The S Flag will be 
set, and the V Flag will be cleared. 


lf Register DFH contains the value FFH (11111111B), Register 07H contains the value 1FH, 
and Register 1FH contains the value BDH (101 11101B) (bit 7, bit 5, bit 4, bit 3, bit 2, and bit 
0 are being tested if they are 1), the statement: 


TCM DFH, @07H 
OpCode: 65 07 DF 


will set the Z Flag indicating the tested bits in the destination operand are 1. The S and VFlags 
are cleared. 


If Working Register R13 contains the value F1H (11110001B), the statement: 


TCM R13, #02H 
OpCode: 66 ED, 02 


tests bit 1 of the destination operand for 1. The Z Flag will be set indicating bit 1 in the 
destination operand was 1. The S and V Flags are cleared. 


lf Register 5DH contains AOH, and Register AOH contains OFH (00001 111B), the statement: 


TCM 5D, #10H 
OpCode: 67 5D 10 


tests bit 4 of the Register AOH for 1. The Z Flag will be reset indicating bit 1 in the destination 
operand was not 1. The S and V Flags are cleared. 
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™ 
TEST UNDER MASK 
™ 
Test Under Mask 
TM dst, src 


instruction Format: 


OPC Address Mode 





Cycles (Hex) dst sic 
oro Ez 7 
Le] 7s 2 
ore ca is 


Operation: dst AND src 


This instruction tests selected bits in the destination operand for logical a 0 value. The bits 
to be tested are specified by setting a 1 bit in the corresponding bit position in the source 
operand (the mask). The TCM instruction ANDs the destination operand with the source 
operand (the mask). The Zero (Z) Flag can then be checked to determine the result. If the Z 
Flag is set, then the tested bits were 0. When the TCM operation is complete, the destination 
and source operands still contain their original values. 


Unaffected 

Set if the result is zero; cleared otherwise. 
Set if the result bit 7 is set; cleared otherwise. 
Always reset to O. 

Unaffected 

Unaffected 


Flags: 


TOSPNO 


Note: Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B (EH) tothe high 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 
then ECH will be used as the destination operand in the OpCode. 


ele] « EL] 


Example: If Working Register R3 contains 45H (01000101B) and Working Register R7 contains the 
value 01H (O0000010B) (bit 1 is being tested if it is 0), the statement: 


TM R3, R7 
OpCode: 72 37 


will set the Z Flag indicating bit 1 in the destination operand is 0. The V and S Flags are 
cleared. 
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™ 
TEST UNDER MASK 


Example: 


Example: 


Example: 


Example: 


Example: 


If Working Register R14 contains the value F3H (11410011B), Working Register R5 contains 
CBH, and Register CBH contains 88H (10001000B) (bit 7 and bit 4 are being tested if they 
are QO), the statement: 


T™ R14, @R5 
OpCode: 73 E5 


will reset the Z Flag, because bit 4 in the destination operand is not a O. The S Flag will be 
set, and the V Flag is cleared. 

If Register D4H contains the value O8H (00001000B), and Working Register RO contains the 
value 04H (000010008B) (bit 3 is being tested if it is 0), the statement: 


TM D4H, RO 
OpCode: 74 EO D4 


will set the Z Flag, because bit 3 in the destination operand is a 0. The S and V Flags will be 
cleared. 


lf Register DFH contains the value OOH (QOOO0000B), Register O7H contains the value 1FH, 
and Register 1FH contains the value BDH (10111101B) (bit 7, bit 5, bit 4, bit3, bit 2, and bit 
0 are being tested if they are 0), the statement: 


TM DFH, @07H 
OpCode: 75 07 DF 


will set the Z Flag indicating the tested bits in the destination operand are 0. The S is set, and 
the V Flag is cleared. 


If Working Register R13 contains the value F1H (11110001B), the statement: 


TM R13, #02H 
OpCode: 76 ED, 02 


tests bit 1 of the destination operand for 0. The Z Flag will be set indicating bit 1 in the 
destination operand was 0. The S and V Flags are cleared. 


If Register 5DH contains AOH, and Register AOH contains OFH (00001 111B), the statement: 


TM 5D, #10H 
OpCode: 77 5D 10 


tests bit 4 of the Register AOH for 0. The Z Flag will be set indicating bit 1 in the destination 
operand was 0. The S and V Flags are cleared. 
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WDH 
WATCH-DOG TIMER ENABLE DURING HALT MODE 


WDH 

Watch-Dog Timer Enable During HALT Mode 
WDH 

instruction Format: OPC 


Cycles (Hex) 





OPC 6 4F 


Operation: When this instruction is executed it will enable the WDT (Watch-Dog Timer) during HALT 
mode. If this instruction is not executed the WDT will stop when entering HALT mode. This 
instruction does not clear the counter, it just makes it possible to have the WDT function 
running during HALT mode. A WDH instruction executed without executing WDT (5FH) has 


no effect. 
Flags: C: Unaffected 
Z: Undefined 
S: | Undefined 
V: Undefined 
D: Unaffected 
H: Unaffected 
Note: The WDH instruction should not be used following any instruction in which the condition of 
the flags is important. 
Example: If the WDT is enabled, the statement: 
WDH 
OpCode: 4F 


will enable the WDT in HALT mode. 
Note: Thisinstructionformatis valid only forthe Z86C04/C07/CO8andZ86E04/E07/E08. 
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WDT 
WATCH-DOG TIMER 


WDT 
Watch-Dog Timer 
WDT 


Instruction Format: OPC 1 


Cycles (Hex) 








OPC 6 5F 


Operation: The WDT (Watch-Dog Timer) is a retriggerable one shot timer that will reset the Z8 if it 
reaches its terminal count. The WDT is initially enabled by executing the WDT instruction. 
Each subsequentexecution of the WDT instruction refreshes the timer and prevents the WDT 
from timing out. 


Flags: C: Unaffected 
Z: Undefined 
S: | Undefined 
V: Undefined 
D: Unaffected 
H: Unaffected 
Note: The WDT instruction should not be used following any instruction in which the condition of 
the flags is important. 
Example: lf the WDT is enabled, the statement: 
WDT 
OpCode: 5F 
refreshes the Watch-Dog Timer. 
Example: The first execution of the statement: 
WDT 
OpCode: 5F 


enables the Watch-Dog Timer. 
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XOR 
LOGICAL EXCLUSIVE OR 
XOR 
Logical Exclusive OR 
XOR dst, sre 
Instruction Format: OPC Address Mode 
Cycles (Hex) dst src 
6 B2 r r 
sil 6 Bs or tt 
10 B4 R R 
10 B6 R IM 
eas Ls] 10 «6B7)C RM 


Operation: 


Flags: 


Note: 


Example: 


dst <— dst XOR src 


The source operand is logically EXCLUSIVE ORed with the destination operand. The XOR 
operation results ina 1 being stored in the destination operand whenever the corresponding 
bits in the two operands are different, otherwise a 0 is stored. The contents of the source 
operand are not affected. 


Unaffected 

Set if the result is zero; cleared otherwise. 

Set if the result of bit 7 is set; cleared otherwise. 
Always reset to 0 

Unaffected 

Unaffected 


LFOSONO 


Address modes R or IR can be used to specify a 4-bit Working Register. In this format, the 
source or destination Working Register operand is specified by adding 1110B(EH) tothe high 
nibble of the operand. For example, if Working Register R12 (CH) is the destination operand, 
then ECH will be used as the destination operand in the OpCode. 


sa 


If Working Register R1 contains 34H (0011 1000B) and Working Register R14 contains 4DH 
(10001 101B), the statement: 


XOR R1, R14 
OpCode: B2 1E 


leaves the value BDH (10111101B) in Working Register R1. The Z, and V Flags are cleared, 
and the S Flag is set. 





12-78 


A 2iLdS 
XOR 


Z8* MICROCONTROLLERS 


LOGICAL EXCLUSIVE OR 


Example: 


Example: 


Example: 


Example: 


Example: 


If Working Register R4 contains F9H (11111001B), Working Register R13 contains 7BH, and 
Register 7B contains GAH (01101010B), the statement: 


XOR R4, @R13 
OpCode: B3 4D 


leaves the value 93H (1001001 1B) in Working Register R4. The S Flag is set, and the Z, and 
V Flags are cleared. 


If Register 3AH contains the value F5H (11110101B) and Register 42H contains the value 
OAH (00001010B), the statement: 


XOR 3AH, 42H 
OpCode: B4 42 3A 


leaves the value FFH (11111111B) in Register 3AH. The S Flag is set, and the C and V Flags 
are cleared. 


If Working Register R5 contains FOH (11110000B), Register 45H contains 3AH, and Register 
3A contains 7F (01111111B), the statement: 


XOR R5, @45H 
OpCode: B5 45 E5 


leaves the value 8FH (10001111B) in Working Register R5. The S Flag is set, and the C and 
V Flags are cleared. 


lf Register 7AH contains the value F7H (11110111B), the statement: 


XOR 7AH, #FOH 
OpCode: B6 7A FO 


leaves the value 07H (00000111B) in Register 7AH. The Z, V and S Flags are cleared. 


If Working Register R3 contains the value 3EH and Register 3EH contains the value 6CH 
(01101100B), the statement: 


XOR @R3, #05H 
OpCode: B7 E3 05 


leaves the value 69H (01101001B) in Register 3EH. The Z, V, and S Flags are cleared. 
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13.1 ZILOG Z8 EMULATOR PRODUCTS 


Zilog provides a family of full-featured real-time in-circuit 
emulators to support Z8® product development. In-circuit 
emulation links your design to a PC to determine how the 
microcontroller is functioning in your design. This greatly 
simplifies system debug, reducing development time and 
OTP device consumption. All emulators include OTP pro- 
gramming, a user configurable WINDOWS interface, a 
Zilog 78® cross assembler and complete Z8® documenta- 


Z8® MICROCONTROLLERS 


USER'S MANUAL 


CHAPTER 13 
ZILOG EMULATORS/SOFTWARE 





tion. Product specifications for the following in-circuit 
emulator kits are also provided: 


m Z86CCPO0ZEM / Z86CCPOOZAC 
m Z86C1200ZEM 


m Z86C5000ZEM 
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13.2 Z8® CCP™ EMULATOR 


QUICK START 


(1) Check Support Package Contents [ia 
(See Other Side) 





Load Software 
1. Select the "Run" command from the "File" menu, located under Microsoft Windows 
“Program Manager". 
a. Insert the disk labeled "Zilog ZASM Cross Assembler/Zilog MOBJ Object File Util." 
in drive A (or drive B, if appropriate. ) 
b. Type "a:\setup" and press ENTER. (Type "b:\setup" if drive B is used.) 
c. Follow on-screen instructions. 
d. Remove diskette and store in a safe place when done. 


For more information on assembling source code, refer to Z8 CCP Emulator 
User's Guide (Appendix C) and the Z8® Microcontrollers Technical Manual. 





2. Select the "Run" command from the "File" menu, located under Microsoft 
Windows "Program Manager". 
a. Insert disk labeled "Z8 GUI S/W" in drive A (or drive B, if appropriate.) 
b. Type "a:\setup" and press ENTER. (Type "b:\setup” if drive B is used.) 
c. Follow on-screen instructions. 
d. Remove diskette and store in a safe place when done. 


Make Connections Your Power 
Power Supply, PC, and Your Design Supply 


Emulation Cable 











Your Design 


Refer to Z8® CCP™ 
Emulator User's Manual 


zs® CCcPp™ 
Emulator 





Connect to 
Observe Electrical Safeguards Power Supply 
(See Z8 CCP Emulator User's Manual) 


aon Zilog ICEBOX GUI Software 
. Double click the Z8-ICE icon. 

2. Select the microcontroller and ROM size 100-Percent Compatible PC 
to be emulated in the Configuration Dialog Box. 

3. Use the "File" menu to download sample files to 
Z8 Code Memory. 

4. Refer to Z8 CCP Emulator User's Manual, 
"Chapter 3: Z8 Emulator Sample Session". 
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13.3 Z8° CCP™ EMULATOR 
PACKAGE CONTENTS 


SUPPORT PRODUCTS PACKAGE CONTENTS 


The Zilog Z8® CCP™ Emulator Support Products Package contains the following items: 


Hardware i 


Z8® CCP™ Emulator Board 
18-Pin DIP-to-DIP Target Cable 
Z86E08 18-Pin DIP OTP Device 


Software 

Z8® GUI S/W Diskette 

Zilog ZASM Cross Assembler/MOBJ Object File Util. Diskette 

Production Languages Corporation (PLC) Compass/Z8™ Diskette (Evaluation Version) 


Description of Z8® GUI Diskette Include Files 


z8cfg.o Configuration 
z8ice.exe Executable 
icehelp.hip Help 
meter.dll Installation library 
readme Text file 
setup. inf Installation information 

setup.exe Windows install program 
z8em_c12.0 On board software for Z86C 12 Icebox 
z8em_c27.0 On board software for Z86C27 Icebox 
z8em_c50.0 On board software for Z86C50 Emulator 
z8em_c62.0 On board software for Z86C62 Emulator 
z8em_c65.0 On board software for Z89C65 Emulator 
z8em_c67.0 On board software for Z89C67 Emulator 
z8em_c93.0 On board software for Z86C93 Emulator 
z8em_!7x.0 On board software for Z86L7X Emulator 
z8em_ccp.o On board software for Z86CCP Emulator 


Publications 


Zilog Z8 CCP Emulator User's Manual 
Z8 Microcontrollers Technical Manual 
Discrete Z8 Microcontrollers Databook 
Registration Card 


Optional Accessory Kit 


An optional accessory kit (P/N Z86CCPOOZAC) available 
from Zilog contains the following items: 

28-Pin ZIF Socket 

40-Pin ZIF Socket 

Power Cable 

28-Pin DIP-to-DIP Target Cable 

40-Pin DIP-to-DIP Target Cable 
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PRODUCT SPECIFICATION 


DEVICES SUPPORTED: Z86C03, Z86C04/E04, Z86C06, Z86C08/E08, Z86C09/19, 
Z86E03/E06; WITH Z8® CCP™ EMULATOR ACC. KIT (Z86CCPZAC): Z86630/E30, 286031/ 


E31, Z86040/E40, 286730, Z86C32 


DESCRIPTION 


The Z86CCPOOZEM is a member of Zilog's family of in- 
circuit emulators. The Z8 CCP emulator provides emula- 
tion and OTP programming support for Zilog's Consumer 
Controller Processor (CCP™) microcontroller. The Emula- 
tor provides all the essential MCU timing and I/O circuitry 
which simplifies user emulation of the prototype hardware/ 
software product. 


The data entering, program debugging, and OTP pro- 
gramming are performed by the monitor ROM and the Host 
Package which communicates through RS-232C serial 
interface with a fixed 19200 baud rate. The user program 
can be downloaded directly from the host computer via an 
RS-232C connector. The user code may then be executed 
using various debugging commands in the monitor. The 
Emulator can be connected to a serial port (COM 1, COM 
2, COM3, COM4) of the host computer (386 or 486, IBM 
compatible PC) and uses Graphical User Interface (GUI) 
software. 


SPECIFICATIONS 


Emulation Specification 
Maximum Emulation Speed: 8 MHz 
Minimum Emulation Speed: 1 MHz 
Power Requirements 
+8V Vdc @O0.5A 
Dimensions 
Width: 


Length: 
Height: 


7.0 in. (17.7 cm) 
9.0 in. (22.9 cm) 
0.9 in. (2.3 cm) 
Serial Interface 


RS-232C @ 19200 baud 


KIT CONTENTS 


Z8® CCP™ Emulator 
CMOS Z86C9320VSC 
RS-232C Interface 
Reset Switch 
20 MHz CMOS Z86C5020FSE ICE Chip 
8K x 8 STATIC RAM (for Code Memory) 
18-Pin DIP ZIF Programming Socket 
18-Pin Target Connector Cable 
Holes Available for 28/40-Pin ZIF Sockets 
Sockets Available for 18/28/40-Pin Target Cables 


Software (IBM PC Platform) 


ZASM Cross-Assembler and MOBJ Object File Util. 

Z8® GUI Emulator Software 

Production Languages Corporation COMPASS/Z8 
(Evaluation Version) 


System Requirements 


386 or 486, IBM Compatible PC 

VGA Video Adapter (Color Monitor Recommended) 
20 MHz, Minimum 

4 Mbytes RAM 

Microsoft Windows 3.0 or 3.1 

Hard Disk Drive (1 Mbyte Free Space) 

High Density (HD) Floppy Disk Drive (3.5-Inch) 
RS-232 COM Port 


Documentation 


Registration Card 

Product Information 

Z8® CCP™ Emulator User's Manual 
Discrete Z8 Databook 

Z8® Microcontroller User's Manual 


ORDERING INFORMATION 


PartNo: Z86CCPO0OZEM 
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13.5 Z86CCPOOZAC EMULATOR KIT 
PRODUCT SPECIFICATION 


DESCRIPTION KIT CONTENTS 


The Z86CCPOOZAC is the accessory kit for the Z8 CCP Emulator Accessory Kit i 
Z86CCPOOZEM. The kit contains all accessories to fully 


populate and operate all functions of the ZB6CCPOOZEM. 28-Pin ZIF Socket 
28-Pin Target Connector Cable 
40-Pin ZIF Socket 
40-Pin Target Connector Cable 
RS-232 Cable 
Power Cable 


ORDERING INFORMATION 


PartNo: Z86CCPO0ZAC 
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PRODUCT SPECIFICATION 


DEVICES SUPPORTED: 286117/717, Z86C04/E04, Z86C07/E07, Z86C08/E08, 
286011, Z86020, 286021/E21, Z86E22, Z86E23, Z86C60, 286061/E61, 


286063/E63, Z86C65, Z86C91 
DESCRIPTION 


The Z86C1200ZEM Z8® Emulator is a member of Zilog's 
ICEBOX™ product family of in-circuit emulators. The 
Z86C1200ZEM provides emulation and OTP program- 
ming support for Zilog's Z8 microcontrollers. The Emulator 
provides all the essential MCU timing and 1/O circuitry 
which simplifies user emulation of the prototype hardware/ 
software product. The data entering, program debugging, 
and OTP programming are performed by the monitor ROM 
and the Host Package which communicates through a RS- 
232C serial interface with a fixed 19200 baud rate. The 
user program can be downloaded directly from the host 
computer through the RS-232C connector. The user code 
may then be executed using various debugging com- 
mands in the monitor. The Emulator can be connected to 
a serial port (COM 1, COM 2, COM3, COM4) of the host 
computer (386 or 486, IBM compatible PC) and uses 
Graphical User Interface (GUI) software. 


SPECIFICATIONS 


Emulation Specification 


Minimum Emulation Speed: 1 MHz 
Maximum Emulation Speed: 16 MHz 


Power Requirements 
+5 Vdc @0.5A 
Dimensions 
Width: 6.25 in. (15.8 cm) 
Length: 9.5 in. (24.1 cm) 
Height: 2.5 in. (6.385 cm) 
Serial Interface 


RS-232C @ 19200 baud 


KIT CONTENTS 
286612 Emulator 


Z8® Emulation Base Board 

CMOS Z86C9120PSC 

8K X 8 EPROM (Programmed with Debug Monitor) 
32K X 8 STATIC RAM 
3 64K X 4 STATIC RAM 
RS-232C Interface 
Reset Switch 

Z86C12 Emulation Daughter Board 
16 MHz CMOS Z86C1216GSE ICE Chip 
18/40-Pin ZIF OTP Sockets 
40/60/80-Pin Target Connectors 


Cables/Pods 


18-Pin DIP Emulation Cable 

28-Pin DIP Emulation Cable 

40-Pin DIP Emulation Cable 

Power Cable with Banana Plugs 
Power Cable with 1A Slow-Blow Fuse 
DB 25 RS-232C Cable 


Software (IBM®-PC Platform) 


ZASM Cross-Assembler and MOBJ Object File Util. 
Z8® GUI Emulator Software 


Documentation 


Emulator User's Manual 

Z8® Cross-Assembler User's Guide 

Universal Object File Utilities (MOBJ) User's Guide 
Registration Card 

Product Information 


ORDERING INFORMATION 


PartNo: Z86C1200ZEM 
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13.7 Z86C5000ZEM EMULATOR 


PRODUCT SPECIFICATION 


DEVICES SUPPORTED: Z86C03, Z86C06, Z86009/19, Z286030/E30, Z86C031/E31, 
286640/E40, 286089, 286090, Z86L06, Z86L29, Z86E03/E06, 286032, 286730 i 


DESCRIPTION KIT CONTENTS 


The Z86C5000ZEM (C50) Emulator is amember of Zilog’s Z86050 Emulator 
ICEBOX™ product family of in-circuit emulators. The C50 


Emulator provides emulation and OTP programming sup- Z8® Emulation Base Board 
port for Zilog’s CCP™ (Consumer Controller Processor) CMOS Z86C9120PSC 
microcontrollers. The C50 Emulator provides all the es- 8K x 8 EPROM (Programmed with Debug Mtr.) 
sential MCU timing and I/O circuitry which simplifies user 32K x 8 Static RAM 
emulation of the prototype hardware/software product. 3 64K x4 Static RAMs 
The Emulator can be connected to a serial port (COM 1, RS-232C Interface 
COM 2, COM3, COM4) of the host computer (386 or 486, Reset Switch 
IBM compatible PC) and uses Graphical User Interface Z86C50 Emulation Daughter Board 
(GUI) software. 20 MHz CMOS Z86C5020GSE ICE Chip 
2K x 8 Static RAM 
SPECIFICATIONS 18/28/40-Pin ZIF OTP Sockets 
6 HP-16500A Logic Analysis System 
Emulation Specification Interface Connectors 
40/60/80-Pin Target Connectors 
Miininum Emulation Speed: 1 MHz 
Maximum Emulation Speed: 20 MHz Cables 
Power Requirements 40-Pin DIP Emulation Cable 
28-Pin DIP Emulation Cable 
; 18-Pin DIP Emulation Cable 
Tare tone Power Cable with Banana Plugs 
Width: 6.25 in. (15.8 cm) Software (IBM PC Platform) 
on atpelk ZASM Cross-Assembler and MOBJ Object File Util. 
Z8® GUI Emulator Software 
Serial Interface harimeantation 
pga ae Neer mae ICEBOX™ User's Manual 
Z8 Cross-Assembler User’s Guide 
System Requirements Windows Host Interface User’s Guide (GUI) 
Universal Object File Utilities (MOBJ) User's Guide 
386 or 486, IBM Compatible PC Registration Card 
VGA Video Adapter (Color Monitor Recommended) 
20 MHz, Minimum ORDERING INFORMATION 
4 Mbytes RAM 
Microsoft Windows 3.0 or 3.1 Part No Z86C5000ZEM 


Hard Disk Drive (1 Mbyte Free Space) 
High Density (HD) Floppy Disk Drive (3.5-Inch) 
RS-232 COM Port 
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13.8 SOFTWARE 





13.8.1 INTRODUCTION 


This section describes some of the important features of 
the Z8®, with software examples that illustrate its power 
and ease of use. It is divided into sections by topic; the 
user need not read each section sequentially, but may skip 
around to the sections of current interest. 


For feature availability and implementation details on a 
particular Z8 device, see the product specification. 





13.9 ACCESSING REGISTER MEMORY 


The Z8 register space consists of I/O ports, control and 
status registers, and general-purpose registers. The gen- 
eral-purpose registers are RAM areas typically used for 
accumulators, pointers, and stack area. This section 
describes these registers and how they are used. Bit 
manipulation and stack operations effecting the register 
space are discussed in other sections of this manual. 


13.9.1 Registers and Register Pairs 


The Z8 supports 8-bit registers and 16-bit register pairs. A 
register pair consists of a an even-numbered register 
concatenated with the next higher numbered register (00 
and 01, 02 and 03, ... FFH). A register pair must be 
addressed by reference to the even-numbered register. 


m F1H and F2H are not a valid register pairs. 


m FOH and FiH are valid register pairs, addressed 
by reference to FOH. 


Register pairs may be incremented (INCW) and 
decremented (DECW) and are useful as pointers for ac- 
cessing program and external data memory. 


Any instruction which can reference or modify an 8-bit 
register can do so to any of the registers in the Z8, 
regardless of the inherent nature of that register. Thus, |I/ 
O ports, control, status, and general-purpose registers 
may all be accessed and manipulated without the need for 
special-purpose instructions. Similarly, instructions which 
reference or modify a 16-bit register pair can do so to any 
of the valid register pairs. 


The only exceptions to this rule are as follows: 


m@ TheDJNZ(decrementand jump if non-zero) instruction 
may successfully operate on the general-purpose 
working registers only. 


m Allwrite-only controlregisters may be modified only by 
such instructions as LOAD, POP, and CLEAR. 
Instructions such as OR and AND require that the 
-current contents of the operand be readable and 
therefore will not function properly on the write-only 
registers. 


13.9.2 Register Pointer 


Within the register addressing modes provided by the Z8®, 
a register may be specified by its full 8-bit address (OOH- 
FFH) or by a short 4-bit address. In the latter case, the 
register is viewed as one of the 16 working registers within 
aworking register group. Such a group must be aligned on 
a 16-byte boundary and is addressed by Register Pointer 
RP (FDH). As an example, assume the Register Pointer 
contains 70, thus pointing to the working register group 
from 70H to 7FH. The LD instruction may be used to 
initialize register 76H to an immediate value in one of two 
ways 


LD 76,4#01H  !8-bit register address is given 
by instruction (3 byte instruction)! 

or 

LD R6,#01H  !4-bit working register address is 


given by instruction; 4-bit work 
ing register group address is 
given by Register Pointer (2 byte 
instruction)! 


A ZiLAS 


The address calculation for the latter case is illustrated in 
Figure 13.1. Notice that 4-bit working-register addressing 
offers code compactness and fast execution compared to 
its 8-bit counterpart. 


To modify the contents of the Register Pointer, the Z8 
provides the instruction 


SRP #value 


Execution of this instruction will load the upper four bits of 
the Register Pointer; the lower four bits are always set to 


Register 
Pointer 


Instruction 
(LD R6, #1) 


Register 
Address 


Z8® MICROCONTROLLERS 
zero. Although a load instruction such as 
LD RP, #value 
could be used to perform the same function, SRP provides 
execution speed (six vs. ten cycles) and code space (two 
vs. three bytes) advantages over the LD instruction. The 
instruction 


SRP  #70H 


is used to set the Register Pointer for the previous example. 





Figure 13-1. Address Calculation Using The Register Pointer 


13.9.3 Context Switching 


A typical function performed during an interrupt service 
routine is context switching. Context switching refers to 
the saving and subsequent restoring of the program 
counter, status, and registers of the interrupted task. 
During an interrupt machine cycle, the Z8® automatically 
saves the Program Counter and status flags on the stack. 
It is the responsibility of the interrupt service routine to 
preserve the register space. The recommended means to 
this end is to allocate a specific portion of the register file 
for use by the service routine. The service routine thus 
preserves the register space of the interrupted task by 
avoiding modification of registers not allocated as its own. 
The most efficient scheme with which to implement this 
function in the Z8 is to allocate a working register group (or 
portion thereof) to the interrupt service routine. In this way, 
the preservation of the interrupted task’s registers is solely 
a matter of saving the Register Pointer on entry to the 
service routine, setting the Register Pointer to its own 
working register group, and restoring the Register Pointer 
prior to exiting the service routine. For example, assume 
such a register allocation scheme has been implemented 
in which the interrupt service routine for IRQO0 may access 
only working register 


Group 4 (registers 40H-4FH). The service routine for IRQO 
should be headed by the code sequence: 


PUSH RP lpreserve Register Pointer of in 
terrupted task! 

SRP #40H laddress working register group 
4! 


Before exiting, the service routine should execute the 
instruction 


POP RP 
to restore the Register Pointer to its entry value. - 


It should be noted thatthe technique described above need 
not be restricted to interrupt service routines. Such a 
technique might prove efficient for use by a subroutine 
requiring intermediate registers to produce its outputs. In 
this way, the calling task can assume that its environment 
is intact upon return from the subroutine. 
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13.9.4 Addressing Mode 


The Z8® provides three addressing modes for accessing 
the register space: Direct Register, Indirect Register, and 
Indexed. 


13.9.5 Direct Register Addressing 


This addressing mode is used when the target register 
address is known at assembly time. Both long (8-bit) 
register addressing and short (4-bit) working register ad- 
dressing are supported in this mode. Most instructions 
supporting this mode provide access to single 8-bit regis- 
ters. For example: 


LD FEH,#HI STACK 


!load register FEH (SPH) with the upper 8- 
bits of the label STACK! 


AND 00H,MASK_REG 


!AND register 0 with register named 
MASK_REG! 


OR 01H,R5 
!OR register 1 with working register 5! 
Increment word (INCW) and decrement word (DECW) are 
the only two Z8 instructions which access 16-bit operands. 
These instructions are illustrated below for the direct regis- 
ter addressing mode: 
INCW RRO 
increment working register pair RO, R 
R1i=R1+1 
RO = RO + carry! 
DECW 7EH 
!decrement working register pair 7EH, 
7FH 
7FH = 7FH - 1 
7EH = 7EH - carry! 
Note that the instruction 


INCW RRS 


will be flagged as an error by the assembler (RR5 not even- 
numbered). 


13.9.6 Indirect Register Addressing 


In this addressing mode, the operand is pointed to by the 
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register whose 8-bit register address or 4-bit working 
register address is given by the instruction. This mode is 
used when the target register address is not known at 
assembly time and must be calculated during program 
execution. For example, assume registers GOH-7FH con- 
tain a buffer for output to the serial line via repetitive calls 
to procedure SERIAL_OUT. SERIAL_OUT expects work- 
ing register 0 to hold the output character. The following 
instructions illustrate the use of the indirect addressing 
mode to accomplish this task: 


LD R1,#20H 
!working register 1 is the byte counter 
output 20H bytes! 

LD R2,#60H 
!working register 2 is the buffer pointer 
register! 

out_again: 

LD RO,@R2 
!load into working register Othe byte pointed 
to by working register 2! 

INC R2 lincrement pointer! 


CALL SERIAL_OUT 
loutput the byte! 

DJNZ R1,out_again 
Hoop till done! 


Indirect addressing may also be used for accessing a 16- 
bit register pair via the INCW and DECW instructions. For 
example: 


INCW @RO 


lincrement the register pair whose ad 
dress is contained in working register O! 


DECW @7FH 


{decrement the register pair whose 
address is contained in register 7FH! 


The contents of registers RO and 7FH should be even 
numbers for proper access; when referencing a register 
pair, the least significant address bit is forced to the 
appropriate value by the Z8. However, the register used to 
point to the register pair need not be an even-numbered 
register. 
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Since the indirect addressing mode permits calculation of 
a target address prior to the desired register access, this 
mode may be used to simulate other, more complex 
addressing modes. For example, the instruction 
SUB 4,BASE(R5) 

requires the indexed addressing mode which is not directly 
supported by the Z8® subtractinstruction. Thisinstructioncanbe 
simulatedasfollows 


LD R6,#BASE 

!working register 6 has the base address! 
ADD R6,R5 

Icalculate the target address! 
SUB 04H,@R6 


Inow use indirect addressing to perform 
the actual subtract! 


Any available register or working register may be used in 
place of R6 in the above example. 


13.9.7 Indexed Addressing 


The indexed addressing mode is supported by the load 
instruction (LD) for the transference of bytes between a 
working register and another register. The effective ad- 
dress of the latter register is given by the instruction which 
is offset by the contents of a designated working (index) 
register. This addressing mode provides efficient memory 
usage when addressing consecutive bytes in a block of 
register memory, such as a table or a buffer. The working 
register used as the index in the effective address calcula- 
tion can serve the additional role of counter to control a 
loop's duration. 


For example, assume an ASCII character buffer exists in 
register memory starting at address BUF for LENGTH 
bytes. In order to determine the logical length of the 
character string, the buffer should be scanned backward 
until the first non-occurrence of a blank character. The 
following code sequence may be used to accomplish this 
task: 


LD RO,#LENGTH 
llength of buffer! 


!starting at buffer end, look for 1st non- 
blank! 
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loop: 
LD R1,BUF-1(RO) 
CP R1i,#'' 
JR ne,found 
!found non-blank! 
DJNZ RO,loop 
!look at next! 
all_blanks: length =O! 
found 


5 instructions 

12 bytes 

6 cycles overhead 

42 cycles per character tested 


At labels “all_blanks” and “found,” RO contains the length 
of the character string. These labels may refer to the same 
location, but they are shown separately for an application 
where special processing is required for a string of zero 
length. To perform this task without indexed addressing 
would require a code sequence such as: 


LD Ri ,#BUF+LENGTH-1 
LD RO,#LENGTH 


!starting at buffer end, look for 1st non-blank! 


loop 1: 
CP @R1,#' ' 
JR ne,found1 
!found non-blank! 
DEC R1 
{dec pointer! 
DJNZ RO0O,loop1 
!are we done’?! 
all_blanks1: length = O! 
found: 


6 instructions 

13 bytes 

12 cycles overhead 

38 cycles per character tested 


The latter method requires one more byte of program 
memory than the former, butis faster by fourexecutioncycles per 
character tested. 
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As an alternative example, assume a buffer exists as 
described above, butitis desired to scan this buffer forward 
for the first occurrence of an ASCIil carriage return. The 
following illustrates the code to do this: 


LD RO,# - LENGTH 
Istarting at buffer start, look for 1st car 
riage return (= ODH)! 


next: 


LD —sr1, BUF + LENGTH(RO) 


— Or. 


CP R1,#0DH 
JR eq,cr 
!foundit! 
INC RO 
lupdate counter/index! 
JR nz,next 
ltry again! 
ADD RO,#LENGTH 


!RO has length to CR! 


7 instructions 

16 bytes 

6 cycles overhead 

48 cycles per character tested 


13.10 Accessing Program and External Data 
Memory 


Ina single instruction, the Z8® can transfer a byte between 
register memory and either program or external data 
memory. Load Constant (LDC) and Load Constant and 
Increment (LDCI) reference program memory; Load Exter- 
nal (LDE) and Load External and Increment (LDEI) refer- 
ence external data memory. These instructions require 
that a working register pair contain the address of the byte 
in either Program or External Data Memory to be accessed 
by the instruction (indirect working register pair address- 
ingmode). The register byte operand is specified by using 
the direct working register addressing mode in LDC and 
LDE or the indirect working register addressing mode in 
LDC! and LDE1. In addition to performing the designated 
byte transfer, LDC! and LDEI automatically increment both 
the indirect registers specified by the instruction. These 
instructions are therefore efficient for performing block 
moves between register and either program or external 
datamemory. Since the indirect addressing mode is used 
to specify the operand address within program or external 
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data memory, more complex addressing modes may be 
simulated. For example, the instruction 


LDC =R3,BASE(R2) 


requires the indexed addressing mode, where BASE is the 
base address of a table in program memory and R2 
contains the offset from table start to the desired table entry. 
The following code sequence simulates this instruction with 
the use of two additional registers (RO and R71 in this 
example): 


LD RO,#HI BASE 
LD R1,#LO BASE 


IRRO has table start address! 


ADD R1,R2 
ADC RO,#0 

!RRO has table entry address! 
LDC R3,@RRO 


IR3 has the table entry! 


13.10.1 Configuring the Z8 for 1/0 
Applications as Opposed to Memory 
Intensive Applications 


The Z8 offers a high degree of flexibility in memory and I/O 
intensive applications. For devices with thirty-two port bits 
provided, 16, 12, eight, or zero may be configured as 
address bits to external memory. This allows for address- 
ing of up to 64K bytes of external memory, which can be 
expanded to 128K bytes if the Data Memory Select output 
(DM) is used to distinguish between program and data 
memory accesses. The following instructions illustrate the 
code sequence required to configure the Z8 with 12 exter- 
nal addressing lines and to enable the Data Memory Select 
output: 


LD PO1M,# 00010010B 


bit 3-4 enable ADO-AD7; 
bit 0-1 enable A8-A11! 


LD P3M,# 000100108 
Ibit 3-4 enable DM! 


The two bytes following the mode selection of Port O and 
Port 1 should not reference external memory due to 
pipelining of instructions within the Z8. Note that the load 
instruction to P3M satisfies this requirement (providing that 
it resides within the internal program memory). 
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13.10.2 LDC and LDE 


To illustrate the use of the Load Constant (LDC) and Load 
External (LDE) instructions, assume there exists a hard- 
ware configuration with external memory and DataMemory 
Select enabled. 


13.10.3 Accessing Program and External 
Data Memory 


LDCl instruction provides an economical means of initializ- 
ing consecutive registers from an initialization table in 
program memory. The following code excerpt illustrates 
this technique of initializing control registers F2H through 
FFH from a 14-byte array (INIT_tab) in program memory: 
SRP #00H 

LD R6,#H! INIT_tab 
LD R7,#LO INIT_tab 
LD R8,#F2H 


!1st reg to be initialized! 
LD R9,#0EH 


!length of register block! 
loop: 


LDCI @R8,@RR6 


!load aregister from the init table! 
DJNZ R9,loop 
!continue till done! 


7 instructions 

14 bytes 

30 cycles overhead 

30 cycles per register initialized 


13.11 BIT MANIPULATIONS 


Support of the test and modification of an individual bit or 
group of bits is required by most software applications 
suited to the Z8 microcomputer. Initializing and modifying 
the Z8 control registers, polling interrupt requests, manipu- 
lating port bits for control of or communication with attached 
devices, and manipulation of software flags for internal 
control purposes are all examples of the heavy use of bit 
manipulation functions. These examples illustrate the 
need for such functions in all areas of the Z8 register space. 


These functions are supported in the Z8 primarily by six 
instructions: 
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13.10.4 LDEI 


The LDEI instruction is useful for moving blocks of data 
between external and register memory since auto-incre- 
ment is performed on both indirect registers designated by 
the instruction. The following code excerpt illustrates a 
register buffer being saved at address 40H through 60H 
into external memory at address SAVE: 


LD R10,#H!I SAVE 

lexternal memory! 
LD R11,#LO SAVE 

laddress! 
LD R8,#40H 


Istarting register! 


sponding mask bit is a 


LD R9,#21H 
logic 1. 


Inumber of registers to save in 
external data memory! 
loop: 
LDE! @RR10,@R8 
linit a register! 
DJNZ R9,loop 
luntil done! 
6 instructions 
12 bytes 


24 cycles overhead 
30 cycles per register saved 


m™ §=6Test Under Mask (TM) 

m@ Test Complement Under Mask (TCM) 
m AND 

m@ OR 


m XOR 


Complement (COM) 
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These instructions may access any Z8® register, regard- 
less of its inherent type (control, I/O, or general-purpose), 
with the exception of the write-only control registers. Table 
13-1 summarizes the function performed on the destina- 
tion byte by each of the above instructions. All of these 
instructions, with the exception of COM, require a mask 
operand. The ‘selected’ bits referenced in Table 13-1 are 
those bits in the destination operand for which the corre- 


Table 13-1 Bit Manipulation Instruction Usage 





Opcode Use 

TM To test selected bits for logic O 

TCM To test selected bits for logic 1 

AND To reset all but selected bits to 
logic O 

OR To set selected bits to logic 1 

XOR To complement selected bits 

COM To complement all bits 


The instructions AND, OR, XOR, and COM have functions 
common to today’s microcontrollers and therefore are not 
described in depth here. However, examples of the use of 
these instructions are laced throughout the remainder of 
this chapter, thus giving an integrated view of their uses in 
common functions. Since they are unique to the Z8, the 
functions of Test under Mask and Test Complement under 
Mask, are discussed in more detail next. 


13.11.1 Test Under Mask (TM) 


The Test under Mask instruction is used to test selected 
bits for logic 0. The logical operation performed is 


destination AND source. 


Neither source nor destination operand is modified; the 
FLAGS control register is the only register affected by this 
instruction. The zero flag (Z) is set if all selected bits are 
logic 0; it is reset otherwise. Thus, if the selected destina- 
tion bits are either all logic 1 or a combination of 1s and Os, 
the zero flag would be cleared by this instruction. The sign 
flag (S) is either set or reset to reflect the result of the AND 
operation; the overflow flag (V) is always reset. All other 
flags are unaffected. Table 13-2 illustrates the flag settings 
which result from the TM instruction on a variety of source 
and destination operand combinations. Note that a given 
TM instruction will never result in both the Z and S flags 
being set. 
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13.11.2 Test Complement Under Mask 
The Test Complement under Mask instruction is used to 
test selected bits for logic 1. The logical operation per- 
formedis 

(NOTdestination)ANDsource. 


Table 13-2 Effects of the TM Instruction 


Destination Source Flags 
(binary) (onary) ZSV 
10001100 01110000 100 
01111100 01110000 000 
10001100 11110000 010 
11111100 11110000 010 
00011000 10100001 100 
01000000 10100001 100 


As in Test under Mask, the FLAGS control register is the 
only register affected by this operation. The zero flag (Z) 
is set if all selected destination bits are 1; it is reset 
otherwise. The sign flag (S) is set or reset to reflect the 
result of the AND operation; the overflow flag (V) is always 
reset. Table 13-3 illustrates the flag settings which result 
from the TCM instruction on a variety of source and 
destination operand combinations. As with the TM instruc- 
tion, a given TCM instruction will never result in both the Z 
and S flags being set. 


Table 13-3 Effects of the TCM Instruction 


Destination Source Flags 
(binary) (binary) ZS V 
10001100 01110000 000 
01111100 01110000 100 
10001100 11110000 000 
11111100 11110000 100 
00011000 10100001 010 
01000000 10100001 010 
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13.12 Stack Operations 


The Z8® stack resides within an area of data memory 
(internal or external). The current address in the stack is 
contained in the stack pointer, which decrements as bytes 
are pushed onto the stack, and increments as bytes are 
popped from it. The stack pointer occupies two control 
register bytes (FEH and FFH) in the Z8 register space and 
may be manipulated like any other register. The stack is 
useful for subroutine calls, interrupt service routines, and 
parameter passing and saving. Figure 13-2 illustrates the 
downward growth of a stack as bytes are pushed onto it. 


13.12.1 Internal as Opposed to External 
Stack 


The location of the stack in data memory may be selected 
to be either internal register memory or external data 
memory. Bit 2 of control register PO1M (F8H) controls this 
selection. Register pair SPH (FEH), SPL (FFH) serves as 
the stack pointer for an external stack. Register SPL is the 
stack pointer for an internal stack. 


In the latter configuration, SPH is available for use as a 
general purpose register. The following illustrates a code 
sequence that initializes external stack operations: 

LD PO1M,#00H 


Ipit 2: select external 
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13.12.2 CALL 


A subroutine call causes the current Program Counter (the 
address of the byte following the CALL instruction) to be 
pushed onto the stack. The Program Counter is loaded with 
the address specified by the CALL instruction. This ad- 
dress may be a direct address or an indirect register pair 
reference. For example: 
LABEL 1 CALL 4F98H 
I\direct addressing: PC is 
loaded with the hex value 4F98; 
address LABEL 1+3 is pushed 
onto the stack! 
LABEL 2 CALL @RR4 
lindirect addressing: PC is 
loaded with the contents of 
working register pair R4, R65; 
address LABEL 2+2 is pushed 
onto the stack! 
LABEL 3 CALL @7EH 
lindirect addressing PC is 
loaded with the contents of 
register pair 7EH, 7FH; 
address LABEL 3+2 is pushed 





stack! onto the stack! 
LD SPH,#HI ‘STACK 
LD SPL,#LO ‘STACK 
Initial Following Following 
State Push R1 Call 


Figure 13-2. Growth Of A Stack 
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13.12.3 RET 


The return (RET) instruction causes the top two bytes to be 
popped fromthe stack and loaded into the Program Counter. 
Typically, this is the last instruction of asubroutine and thus 
restores the PC to the address following the CALL to that 
subroutine. 


13.12.4 Interrupt Machine Cycle 


During an interrupt machine cycle, the PC followed by the 
status flags is pushed onto the stack. A more detailed 
discussion of interrupt processing is provided in sections 
that follow. 


13.12.5 IRET 


The interrupt return (IRET) instruction causes the top byte 
to be popped from the stack and loaded into the status flag 
register, FLAGS (FCH); the nexttwo bytes are then popped 
and loaded into the Program Counter. In this way, status is 
restored and program execution continues where it had left 
off when the interrupt was recognized. 


13.13 Interrupts 


The Z8® recognizes six different interrupts from internal 
and external sources, including internal timer/counters, 
serial I/O, and Port 3 lines. Interrupts may be individually 
or globally enabled/disabled using the Interrupt Mask 
Register IMR (FBH) and may be prioritized for simulta- 
neous interrupt resolution using the Interrupt Priority 
Register IPR (F9H). When enabled, interrupt request 
processing automatically vectors to the designated ser- 
vice routine. When disabled, an interrupt request may be 
polled to determine when processing is needed. 


13.13.1 Interrupt Initialization 


Before the Z8 can recognize interrupts following RESET, 
some initialization tasks must be performed. The initializa- 
tion routine should configure the Z8 interrupt requests to be 
enabled/disabled, as required by the target application and 
assigned a priority (via IPR) for simultaneous enablea- 
interrupt resolution. An interrupt request is enabled if the 
corresponding bit in the IMR is set (=1) and interrupts are 
globally enabled (bit 7 of IMR =1). An interrupt request is 
disabled if the corresponding bit in the IMR is reset (=O) or 
interrupts are globally disabled (bit 7 of IMR =0). 


A RESET of the Z8 causes the contents of the Interrupt 
Request Register IRQ (FAH) to be held to zero until the 
execution of an El instruction. Interrupts that occur while 
the Z8 is in this initial state will not be recognized since the 
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13.12.6 PUSH and POP 


The PUSH and POP instructions allow the transfer of bytes 
between the stack and register memory, thus providing 
program access to the stack for saving and restoring 
needed values and passing parameters to subroutines. 


Execution of a PUSH instruction causes the stack pointer 
to be decremented by 1, the operand byte is then loaded 
into the location pointed to by the decremented stack 
pointer. Execution of a POP instruction causes the byte 
addressed by the stack pointer to be loaded into the 
operand byte; the stack pointer is then incremented by 1. In 
both cases, the operand byte is designated by either a 
direct register address or an indirectregister reference. For 
example: 


PUSH R1 lindirect address: push working 
register 1 onto the stack! 

POP 05H !direct address: pop the top 
stack byte into register 5! 

PUSH @R4 indirect address: pop the top 
stack byte into the byte 
pointed to by working register 4! 

PUSH @11H — !indirect address: push onto 


the stack the byte pointed to 
by register 17! 


corresponding IRQ bit cannot be set. The El instruction is 
specially decoded by the Z8 to enable the IRQ; simply 
setting bit 7 of IMR is therefore not sufficient to enable 
interrupt processing following RESET. However, subse- 
quent to this initial El instruction, interrupts may be globally 
enabled either by the instruction: 


El lenable interrupts! 
or by a register manipulation instruction such as 

OR IMR,#80H 
To globally disable interrupts, execute the instruction 

DI disable interrupts! 
This will cause bit 7 of IMR to be reset. 
Interrupts must be globally disabled prior to any modifica- 
tion of the IMR, IPR or enabled bits of the IRQ (those 
corresponding to enabled interruptrequests), unless itcan 
be guaranteed that an enabled interrupt will not occur 
during the processing of such instructions. Since interrupts 
represent the occurrence of events asynchronous to pro- 


gram execution, it is highly unlikely that such a guarantee 
can be made reliably. 
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13.13.2 Vectored Interrupt Processing 


Enabled interrupt requests are processed in an automatic 
vectored mode in which the interrupt service routine ad- 
dress is retrieved from within the first 12 bytes of Program 
Memory. When an enabled interruptrequest is recognized 
by the Z8, the Program Counter is pushed onto the stack 
(low order 8 bits first, then high-order 8 bits) followed by the 
FLAGS register (FCH). The corresponding interrupt re- 
quest bitis resetin IRQ, interrupts are globally disabled (bit 
7 of IMR is reset), and an indirect jump is taken on the word 
in location 2x, 2x + 1 (x = interrupt request number ,Osxs<5). 
For example, if the bytes at addresses 0004H and 0005H 
contain 05H and 78H respectively, the interrupt machine 
cycle for IRQ2 will cause program execution to continue at 
address 0578H. 


When interrupts are sampled, more than one interrupt may 
be pending. The Interrupt Priority Register (IPR) controls 
the selection of the pending interrupt with highest priority. 
While this interrupt is being serviced, a higher-priority 
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interrupt may occur. Such interrupts may be allowed 
service within the current interrupt service routine (nested) 
or may be held until the current service routine is complete 
(non-nested). 


To allow nested interrupt processing, interrupts must be 
selectively enabled upon entry to an interrupt service 
routine. Typically, only higher-priority interrupts would be 
allowed to nest within the current interrupt service. To do 
this an interrupt routine must “know” which interrupts have 
a higher priority than the current interrupt request. Selec- 
tion of such nesting priorities is usually a reflection of the 
priorities established in the Interrupt Priority Register (IPR). 
Given this data, the first instructions executed in the service 
routine should be to save the current Interrupt Mask Reg- 
ister , mask off all interrupts of lower and equal priority, and 
globally enable interrupts (El). For example, assume that 
service of interrupt requests 4 and 5 are nested within the 
service of interrupt request 3. The following illustrates the 
code required to enable IRQ4 and IRQS: 


Iservice routine for IRQ3! 


linterrupts were globally disabled during the interruptmachine cycle -no 
DI is needed prior to modification of IMR! 


Idisable all but IRQ4 & 5! 


linterrupts are globally enabled now — must disable them prior to 
modification of IMR! 


CONSTANT 
INT.MASK_3 = 001710000B 
GLOBAL 
IRQ3_service PROCEDURE ENTRY 
PUSH IMR 
AND — IMR,#INT_MASK_3 
El 
I. !service interrupt! 
DI 
POP IMR trestore entry IMR! 
IRET 


END IRQ3_service 


Note: IRQ4 and IRQ5 are enabled by the above sequence after IRQ3_service only if their respective IMR bits = 1 on entry to 


IRQ3_service. 
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Note (Continued): 
The service routine for an interrupt whose processing is to be completed without interruption should not allow interrupts 


to be nested within it. Therefore, it need not modify the IMR, since interrupts are disabled automatically during the interrupt 
machine cycle. 


The service routine for an enabled interrupt is typically concluded with an IRET instruction, which restores the FLAGS 
register and Program Counter from the top of the stack and globally enables interrupts. To return from an interrupt service 
routine without re-enabling interrupts, the following code sequence could be used: 
POP FLAGS 
IFLAGS=@6P! 
RET IPC=@SP! 


This accomplishes all the functions of IRET, except that IMR is not affected. 
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13.13.3 Polled Interrupt Processing 


Disabled interrupt requests may be processed in a polled 
mode, in which the corresponding bits of the Interrupt 
Request Register (IRQ) are examined by the software. 
When an interrupt request bit is found to be a logic 1, the 
interrupt should be processed by the appropriate service 
routine. During such processing, the interrupt request bit in 
the IRQ must be cleared by the software in order for 
subsequent interrupts on that line to be distinguished from 


!poll interrupt inputs here! 


TCM IRQ, #00010000B 

JR NZ,TESTO 

CALL IRQ4_service 
TESTO TCM IRQ, #00000001B 

JR NZ,TEST1 

CALL IRQO_service 
TEST1 TCM IRQ, #00000010B 

JR NZ, DONE 

CALL IRQ1_service 
DONE !...! 
IRQ4_service PROCEDURE ENTRY 

lt 

AND IRQ, #11101111B 

bt 

RET 


END IRQ4_service 


IRQO_service PROCEDURE ENTRY 


AN IRQ, #11111110B 


END IRQO_service 


IRQ1_service PROCEDURE ENTRY 


IRQ, #11111101B 
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the current one. If more than one interrupt request is to be 
processed in a polled mode, polling should occur in the 
order of established priorities. For example, assume that 
IRQO, IRQ1, and IRQ4 are to be polled and that established 
priorities are, from high to low, IRQ4, IRQO, IRQ1. An 
instruction sequence like the following should be used to 
poll and service the interrupts: 


'IRQ4 need service?! 
Ino! 
lyes! 


'IRQO need service?! 


Ino! 


1IRQ1 need service ?! 
Ino! 


Iclear IRQ4! 


Iclear IRQO! 


Iclear IRQ1! 
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13.14 Timer/Counter Functions 


The Z8® provides two 8-bit timer/counters, TO and T1, that 
are adaptable to a variety of application needs and thus 
allow the software (and external hardware) to be relieved 
of the bulk of such tasks. Included in the set of such uses 
are: 


@ Internal Delay Timer 

m Maintenance of a Time-Of-Day Clock 

m@ Watch-Dog Timer 

m External Event Counting 

@ Variable Pulse Train Output 

™@ Duration Measurement of External Event 

m Automatic Delay Following External Event Detection 


Each timer/counter is driven by its own 6-bit prescaler, 
which is in turn driven by the internal Z8 clock divided by 
four. ForT,, the internal clock may be gated or triggered by 
an external event or may be replaced by an external clock 
input. Each timer/counter may operate in either single- 
pass or continuous mode where, at end-of-count, either 
counting stops or the counter reloads and continues count- 
ing. The counter and prescaler registers may be altered 
individually while the timer/counter is running; the software 
controls whether the new values are loaded immediately or 
when end-of-count (EOC) is reached. 


Although the timer/counter prescaler registers (PREO and 
PRE1) are write-only, there is a technique by which the 
timer/counters may simulate a readable prescaler. This 
capability is a requirement for high resolution measure- 
ment of an event's duration. The basic approach requires 
thatone timer/counter be initialized with the desired counter 
and prescaler values. The second timer/counter is initial- 
ized with a counter equal to the prescaler of the first timer/ 
counter and a prescaler of 1. The second timer/counter 
must be programmed for continuous mode. With both 
timer/counters driven by the internal clock and started and 
stopped simultaneously, they will run synchronous to one 
another; thus, the value read from the second counter will 
always be equivalent to the prescaler of the first. 


13.14.1 Time/Count Interval Caiculation 
To determine the time interval (i) until EOC, the equation 


i=txpxv 
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characterizes the relation between the prescaler (p), 
counter (v), and clock input period (t); is given by 


1/(XTAL/8) 
(assumes internal clock set for XTAL divide by 2 mode) 


where XTAL is the Z8 input clock frequency; p is in the 
range 1-64; v is in the range 1-256. When programming 
the prescaler and counter registers, the maximum load 
value is truncated to six and eight bits, respectively, andis 
therefore programmed as zero. For an input clock 
frequencyof 8 MHz, the prescaler and counter register 
values may be programmed to time an interval in the range 


jusx1x1<is 1us x 64x 256 
lus $is 16.384 ms 


To determine the count (c) until EOC for T, with external 
clock input, the equation 


C=pPXV 


characterizes the relation between the T, prescaler (p) and 
the T, counter (v). The divide-by-8 on the input frequency 
is bypassed in this mode. The count range is 


1x1scs64~x 256 
1<c<s 16,384 


13.14.2 T,,,, Modes 


Port 3, bit 6 (P36) may be configured as an output (T 


our) 
which is dynamically controlled by one of the following : 


a T, 
a UT, 
m@ Internal Clock 


When driven by T, or T,, T,,, is reset to a logic 1 when the 
corresponding load bit is set in timer control register TMR 


(F1H) and toggles on EOC from the corresponding counter. 


When T,,, is driven by the internal clock, that clock is 
directly output on P36. 


While programmed as T,,,, P36 is disabled from being 
modified by a write to port register O3H; however, its current 
output may be examined by the Z8 software by a read to 
port register O3H. 
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13.14.3 T,, Modes 


Port 3, bit 1 (P31) may be configured as an input (T,,) which 
is used in conjunction with T1 in one of four modes. 


m External Clock Input 

m Gate Input for Internal Clock 

m Nonretriggerable Input for Internal Clock 
m Retriggerable Input for Internal Clock 


For the latter two modes, it should be noted that the 
existence of a synchronizing circuit within the Z8® causes 
a delay of two to three internal clock periods following an 
external trigger before clocking of the counter actually 
begins. 


Each High-to-Low transition on T,, will generate interrupt 
request IRQ2, regardless of the selected T,, mode or the 
enabled/disabled state of T1. IRQ2 must therefore be 
masked or enabled according to the needs of the applica- 
tion. 


The ‘external clock input’ T,, mode supports the counting 
of external events, where an eventis seen as a High-to-Low 
transition on T,,. Interrupt request IRQ5 is generated on 
the nth occurrence (single-pass mode) or on every nth 
occurrence (continuous mode) of that event. 


The “gate input for internal clock” T,, mode provides for 
duration measurement of an external event. In this mode, 
the T1 prescaler is driven by the Z8 internal clock, gated by 
a High level on T,,. In other words, 11 will count while T,,, 
is High and stop counting while Tis Low. Interruptrequest 
IRQ2 is generated on the High-to-Low transition on T,,. 
Interruptrequest IRQ5 is generated onT1 EOC. Thismode 
may be used when the width of a High-going pulse needs 
to be measured. Inthismode, IRQ2is typically the interrupt 
request of most importance, since it signals the end of the 
pulse being measured. If IRQ5 is generated prior to IRQ2 
in this mode, the pulse width on T,, is too large for T1 to 
measure in a single pass. 
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The “nonretriggerable input” T,,, mode provides for auto 
matic delay timing following an external event. In this 
mode, T1 is loaded and clocked by the Z8 internal clock 
following the first High-to-Low transition on T,, after T1 is 
enabled. T,, transitions that occur after this point do not 
affect T,. In single-pass mode, the enable bit is reset on 
EOC; further T,, transitions will not cause T, to load and 
begin counting until the software sets the enable bit again. 
In continuous mode, EOC does not modify the enable bit, 
but the counter is reloaded and counting continues imme- 
diately; IRQ5 is generated every EOC until software resets 
the enable bit. This T,, mode may be used, for example, 
to time the line feed delay following end of line detection on 
a printer or to delay data sampling for some length of time 
following a sample strobe. 


The “retriggerable input” T,, mode will load and clock T, 
with the Z8 internal clock on every occurrence of a High- 
to-Low transition on T,,. T, will time-out and generate 
interrupt request IRQ5 when the programmed time interval 
(determined by T1 prescaler and load register values) has 
elapsed since the last High-to-Low transition on T,,. In 
single-pass mode, the enable bit is reset on EOC; further 
T,, transitions will not cause T1 to load and begin counting 
until the software sets the enable bit again. In continuous 
mode, EOC does not modify the enable bit, but the counter 
is reloaded and counting continues immediately; IRQ5 is 
generated at every EOC until the software resets the 
enable bit. This T,, mode may provide such functions as 
watch-dog timer (in other words, interrupt if conveyor belt 
stopped or clock pulse missed), or keyboard time-out (in 
other words., interrupt if no input in x ms). 
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13.14.4 Examples 


Several possible uses of the timer/counters are given in the 
following four examples. 


13.14.5 Time-Of-Day Clock 
The following module illustrates the use of T1 for mainte- 


nance of a time-of-day clock, which is kept in binary format 
in terms of hours, minutes, seconds, and hundredths of a 
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second. Itis desired that the clock be updated once every 
hundredth of a second; therefore,T1, is programmed in 
continuous mode to interrupt 100 times a second. Al- 
though T1 is used for this example, TO is equally suited for 
the task. 


The procedure for initializing the timer (TOD_INIT), the 
interrupt service routine (TOD) which updates the clock, 
and the interrupt vector forT1 end-of-count (IRQ_5) are 
illustrated below (XTAL = 7.3728 MHz, XTAL/2 mode is 
assumed): 


Z8ASM 2.0 
LOC OBJ CODE STMT SOURCE STATEMENT 
1 TIMER1 MODULE 
2 CONSTANT 
3 HOUR= R12 
4 MINUTE = R13 
5 SECOND = R14 
6 HUND = R15 
7 $SECTION PROGRAM 
8 GLOBAL 
9 1IRQ5 interrupt vector! 
10 $ABS 10 
P 0000 OOOF’ 11 IRQ_5 ARRAY([1 WORD] = [TOD] 
12 
13 $REL 
P QO0C 14 TOD_INIT PROCEDURE 
15 ENTRY 
P 0000 E6 F3 93 16 LD PRE1,#10010011B 
17 pit 2-7 prescaler = 36; 
18 bit 1 internal clock; 
19 bitO continuous mode! 
P 0003 E6 F2 00 20 LD T1,#00H 1(256) time-out = 
21 1/100 second! 
P 0006 46 F1 OC 22 OR TMR,#OCH lload, enable T1! 
P 0009 8F 23 DI 
P QO0A 46 FB 20 24 OR IMR,#20H lenable T1 interrupt! 
P QOOD 9F 25 El 
P QOOE AF 26 RET 
P OOOF 27 END TOD_INIT 
28 
P OOOF 29 TOD PROCEDURE 
30 ENTRY 
P OOOF 70 FD 31 PUSH RP 
32 !Working register file 10H to 1FH contains 
33 the time of day clock! 
P0011 31 10 34 SRP  #10H 
P 0013 FE 35 INC HUND !'1 more .01 sec! 
P 0014 A6 EF 64 36 CP HUND,#64H lfull second yet?! 
P 0017 EB 13 37 JR NE, TOD_EXIT liump if no! 
P 0019 BO EF 38 CLR  HUND 
P 001B EE 39 INC SECOND !{ more second! 
P 001C A6 EE 3C 40 CP SECOND,#3CH lfull minute yet?! 
P 001F EB OB 41 JR NE, TOD_EXIT liump if no! 
P 0021 BO EE 42 CLR SECOND 
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P 0023 DE 

P 0024 A6 ED 3C 
P 0027 EB O3 

P 0029 BO ED 

P 002B CE 


P 002C 50 FD 
P 002E BF 
P 002F 


O ERRORS 


ASSEMBLY COMPLETE 


TOD_INIT 

7 instructions 
15 bytes 

16 us 


INC) MINUTE 

CP MINUTE,#3CH 

JR NE, TOD_EXIT 

CLR MINUTE 

INC HOUR 
TOD_EXIT: 


POP RP 
IRET 

END TOD 

END TIMER 


TOD 
17 instructions 
32 bytes 


!1 more minute! 
!full hour yet?! 
Ijump if no! 


lrestore entry RPI 


19.5 us (average) including interrupt response time 
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13.14.6 Variable Frequency, Variable Pulse 
Width Output 


The following module illustrates one possible use of T,,,,. 
Assume it is necessary to generate a pulse train with a 10 
percent duty cycle, where the outputis repetitively high for 
1.6 ms and then low for 14.4 ms. To do this, T,,, is 
controlled by end-of-count from T1, although TO could 
alternately be chosen. This examples makes use of the Z8 
feature that allows a timer’s counter register to be modified 
without disturbing the count in progress. In continuous 
mode, the new value is loaded when T1 reaches EOC. T1 
is first loaded and enabled with values to generate the 
short interval. The counter register is then immediately 
modified with the value to generate the long interval; this 
value is loaded into the counter automatically on T1 EOC. 
The prescaler selected value must be the same for both 
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long and short intervals. Note that the initial loading of the 
T1 counter register is followed by setting the T1 load bit of 
timer control register TMR (F1H); this action causes T,,,, to 
be reset to alogic 1 output. Each subsequent modification 
of the T1 counter register does not affect the current T,,,, 
level, since the T1 load bit is NOT altered by the software. 
The new value is loaded on EOC and T,,,, will toggle at that 
time. The T1 interrupt service routine should simply modify 
the T1 counter register with the new value, alternating 


between the long and short interval values. 


In the example which follows, bit 0 of register 04H is used 
as a software flag to indicate which value was loaded last. 
This module illustrates the procedure for T1/T,,,,, initializa- 
tion(PULSE_INIT), the T1 interruptservice routine (PULSE), 
and the interrupt vector forT1, EOC (IRQ_5). XTAL = 8 
MHz, XTAL/2 mode is assumed. 


Z8ASM 2.0 
LOC OBJ CODE STMT SOURCE STATEMENT 
1 TIMER2 MODULE 
2 $SECTION PROGRAM 
3 GLOBAL 
4 !|RQ5 interrupt vector! 
5 ABS 10 
P 0000 0017’ 6 IRQ_5 ARRAY[1 WORD] = [PULSE] 
7 
8 $REL 
P Q00C 9 PULSE_INIT PROCEDURE 
10 ENTRY 
P 000 E6 F3 03 11 LD PRE1,#0000001 1B 
12 pit 2-7 prescaler= 64; 
13 bit 1 internal clock; 
14 bit O continuous mode! 
P 0003 E6 F7 00 15 LD P3M,#00H !bit 5: P36 = output (T,, ,)! 
P Q006 E6 F2 19 16 LD 71,#19H !for short interval! 
P 0009 8F 17 DI 
P QOOA 46 FB 20 18 OR IMR,#00100000B lenable T1 interrupt! 
P OOOD E6 Fi 8C 19 LD TMR,#10001 100B 
20 Ibit 6-7 Tout controlled 
21 by 71; 
22 bit 3 enable 11; 
23 bit 2 load T1! 
24 !Set long interval counter, to be loaded on T1 EOC! 
P 0010 E6 F2 E1 25 LD T1,#0E1H 
26 !Clear alternating flag for PULSE! 
P 0013 BO 04 27 CLR O4H =O 25 next; 
28 = 1 225 next! 
P 0015 9F 29 E| 
P 0016 AF 30 RET 
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P 0017 31 END PULSE_INIT 
32 
33 
P 0017 34 PULSE PROCEDURE 
35 ENTRY 
P 0017 E6 F2 E1 36 LD T1,#0E1H Inew load value! 
P OO1A B6 04 O71 37 XOR 04H,#01H lwhich value next?! 
P 001D 6B 03 38 JR Z,PULSE_EXIT !should be 225! 
P OO1F E6 F2 19 39 LD T1,4#19H Ishould be 25! 
40 PULSE_EXIT 
P 0022 BF 41 IRET 
P 0023 42 END PULSE 
43 END  TIMER2 
O ERRORS 
ASSEMBLY COMPLETE 
PULSE_INIT PULSE 
10 instructions 5 instructions 
23 bytes 12 bytes 
23 us 25 us (average) including interrupt response time 
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13.14.7 Cascaded Timer/Counters 


For some applications it may be necessary to measure a 
greater time interval than a single timer/counter can mea- 
sure (16.384 ms). In this case, T,, and T,,,, may be used 
to cascade T0 and 11 to function as a single unit. T,,,, 
programmed to toggle on TO end-of-count, should be 
wired back to T,,, which is selected as the external clock 
input for T1. With TO programmed for continuous mode, 
Toyz (and therefore T,,.) goes through a High-to-Low transi- 
tion (causing T1 to count) on every other TO EOC. Interrupt 
request IRQ5 is generated when the programmed time 
interval has elapsed. Interrupt requests IRQ2 (generated 
on every T,,, High-to-Low transition) and IRQ4 (generated 
onT0 EOC) are of no importance in this application and are 
therefore disabled. 


To determine the time interval (i) until EOC, the equation 
i=txpOxv0x(2xp1 xvi- 1) 


characterizes the relation between the TO prescaler (p0) 
and counter (vO), the T1 prescaler (p1) and counter (v1), 
and the clock input period (t). Assuming XTAL = 8 MHz, the 
measurable time interval range is: 


1usx1x1x(2x1-1)sis 
1 us x 64 x 256 x (2 x 64 x 256 - 1) 
1 us $i $ 536.854528 s 


Figure 13-3 illustrates the interconnection between TO and 


T1. The following module illustrates the procedure required 
to initialize the timers for a 1.998 second delay interval 
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XTAL 


8-Bit TO 
Counter 


Tout (P3g) 





To interrupt Logic (IRQ4) 


Tin (P34) 


6-Bit T1 
Prescaler 


8-Bit T1 
Counter 


To Interrupt Logic (IRQ5) 


Figure 13-3. Cascaded Timer/Counters 
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Z8ASM 2.0 


LOC OBJ CODE 


P 0000 


P 0000 E6 F3 28 


P 0003 E6 F7 00 
P 0006 E6 F2 64 
P 0009 E6 F5 29 


P OOOC E6 F4 64 
P OOOF 8F 
P 0010 56 FB 2B 


P 0013 46 FB 20 


P 0016 OF 
P 0017 E6 F1 4F 


P 001A AF 
P 001B 


O ERRORS 


STMT SOURCE STATEMENT 


1 


=O OANA AH WMH 


—k ob 


ASSEMBLY COMPLETE 


11 instructions 
27 bytes 
26.6 us 


TIMERS 
GLOBAL 
TIMER_16 
ENTRY 

LD 


RET 


MODULE 
PROCEDURE 


PRE1,#00101000B 


P3M,#00H 
T1,#64H 
PREO,#00101001B 
T0,#64H 
IMR,#00101011B 
IMR,#00100000B 


TMR,#01001111B 


END TIMER_16 
END TIMERS 
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!bit 2-7 prescaler = 10; 
bit 1 external clock; 

bit O single-pass mode! 
Ibit 5 let P36 be Tout! 
!T1 counter register! 

12 

!bit 2-7 prescaler = 10; 
bit O continuous mode! 
!TO counter register! 


Idisable IRQ2 (Tin); 
and IRQ4 (TO)! 
tenable IRQ5 (T1)! 


Ibit6-7T, ,controlled 
by TO; 

bit4-5T, modeisext. 
clockinput; 

bit 3 enable T1; 
bit 2 load T1; 

bit 1 enable TO; 
bit O enable T0! 
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13.14.8 Clock Monitor 


T1 and T,, may be used to monitor a clock line (in a diskette 
drive, for example) and generate an interrupt request 
when a clock pulse is missed. To accomplish this, the 
clock line to be monitored is wired to PS, (T,,,). T,, should be 
programmed as a retriggerable input to T,, such that each 
falling edge on T,, will cause T1 to reload and continue 
counting. If T1 is programmed to time-out after an interval 
of one-and-a-half times the clock period being monitored, 
T1 will time-out and generate interrupt request IRQ5 only 
if a clock pulse is missed. 
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The following module illustrates the procedure for initializ- 
ing T1 and T,, (MONITOR_INIT) to monitor a clock with a 
period of 2us. XTAL = 8 MHz is assumed. Note that this 
example selects single-pass rather than continuous mode 
for T1. This is to prevent a continuous stream of IRQ5 
interruptrequests in the event that the monitored clock fails 
completely. Rather, the interrupt service routine (CLK_ERR) 
is left with the choice of whether or not to re-enable the 
monitoring. Also shown is the T1 interrupt vector (IRQ_5). 


Z8ASM 2.0 
LOC OBJ CODE STMT SOURCE STATEMENT 

1 TIMER4 MODULE 

2 $SECTION PROGRAM 

3 GLOBAL 

4 !1RQ5 interrupt vector! 

5 $ABS 10 
P 0000 0015’ 6 IRQ_5 ARRAY[1 WORD] = [CLK_ERR] 

7 

8 $REL 
P 000C 9 MONITOR_INITPROCEDURE 

10 ENTRY 
P 0000 E6 F3 04 11 LD PRE1,#00000100B 

12 [bit 2-7 prescaler =1; 

13 bit 1 external clock; 

14 bit O single-pass mode! 
POOOSE6F700 15 LD P3M,#00H IbitSletP36beT,, ,! 
POOOGE6F203 6 LD T1,08H IT1loadregister, 

17 = 1.5*2usec! 
P 0009 8F 18 DI 
POOOAS6FB3B 19 AND sIMR#00111011B IdisableIRQ2(T,,)! 
POOOD46FB20 @ CR IMR#00100000B lenablelRQ5(T 1)! 
POQO109F 21 El 

22 
P 0011 E6 F1 38 23 LD TMR,#001 1 1000B 

4 Ibit4-5T, modeis 

25 retrig. input; 

26 bit 3 enable T1! 
P 0014 AF 27 RET 
P 0015 28 END MONITOR_INIT 

29 

30 
P 0015 31 CLK_ERR PROCEDURE 

32 ENTRY 

33 I... {handle the missed clock! 

34 

35 lif clock monitoring should continue...! 
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P 0015 46 F1 08 36 OR TMR, #00001000B 
37 

P 0018 BF 38 IRET 

P 0019 39 END CLK_ERR 
40 END TIMER4 

O ERRORS | 

ASSEMBLY COMPLETE 

MONITOR_INIT CLK_ERR 

9 instructions 2+ instructions 

21 bytes 4+ bytes 

21.5 us 18.5 us+ including interrupt response time 


13.15 1/0 FUNCTIONS 


The Z8® provides up to 32 I/O lines mapped into registers 
0-3 of the internal register file. Each nibble of Port 0 is 
individually programmable as input, output, or address/ 
data lines (A15-A12, A11-A8). Port 1 is programmable as 
a byte entity to provide input, output, or address/data lines 
(AD7-ADO). The operating modes for the bits of Ports 0 
and 1 are seiected by control register PO1M (F8H). Selec- 
tion of I/O lines as address/data lines supports access to 
external program and Data Memory. Each bit of Port 2 is 
individually programmable as an input or an output bit. 
Port 2 bits programmed as outputs may also be pro- 
grammed (via bit O of P3M) to all have active pull-ups or all 
be open-drain (active pull-ups inhibited). In Port 3, four 
bits (P30-P33) are fixed as inputs, and four bits (P34-P37) 
are fixed as outputs, but their functions are programmable. 
Special functions provided by Port3 bits are listed in Table 
13-4. 


Note: |/O feature options are device dependent. Consult the 
selected Z8 device product specification for exact I/O features 
available. 
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bit 3: enable T1 ! 





Table 13-4. Generic Z8 MCU Port 3 
Special Functions 


FUNCTION BIT SIGNAL 


P31 DAV2/RDY2 
P32 DAVO/RDYO 
P32 DAV1/RDY1 
Handshake P34  RDY1/DAV1 
P35. RDYO/DAVO 
P36. RDY2/DAV2 


P30 = IRQ3 
Interrupt P31 IRQ2 
Request P32 IRQO 

P33 = IRQ1 
Counter/ P31 oT, 
Timer P36 Tous 
Data Memory 
Select P34 DM 
Status Out 

P30 _—_— Serial In 
Serial |/O P37 = Serial Out 
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13.15.1 Asynchronous Receiver/Transmitter 
Operation 


In some cases, full-duplex, serial asynchronous receiver/ 
transmitter operation is provided using P37 (output) and 
P30 (input) in conjunction with control register SIO (FOH), 
SIO is actually two registers: a receiver buffer and a 
transmitter buffer. Counter/Timer TO provides the clock for 
control of the bit rate. 


The Z8® always receives and transmits eight bits between 
start and stop bits. However, if parity is enabled, the eighth 
bit (D7) is replaced by the odd-parity bit when transmitted 
and a parity-error flag (= 1 if error) when received. Table 
13-5 illustrates the state of the parity bit/parity error flag 
during serial I/O with parity enabled. 
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Although the Z8 directly supports either odd parity or no 
parity for serial I/O operation, even parity may also be 
provided with additional software support. To receive and 
transmit with even parity, the Z8 should be configured for 
serial I/O with odd parity disabled. The Z8 software must 
calculate parity and modify the eighth bit prior to the load 
of a character into SIO and then modify a parity error flag 
following the load of a character from SIO. All other 
processing required for serial I/O (in other words, buffer 
management, error handling, and other processing) is the 
same as that for odd parity operations. 


Table 13-5. Serial /O With Odd Parity 





Character Loaded Transmitted To Received From Transferred 

Into SIO Serial Line Serial Line Character To SIO Note* 
1100001 1 0100001 1 0100001 1 0100001 1 no error 
11000011 01000011 01000111 11000111 error 
01111000 11111000 11111000 01111000 no error 
01111000 11111000 01111000 11111000 error 





* Left most bit is D7 
To configure the Z8 for Serial 1/O, it is necessary to: 


Enable P30 and P37 for serial 1/O and select parity, 


Set up TO for the desired bit rate, 


Configure IRQ3 and IRQ4 for polled or automatic 
interrupt mode, 


m Load and enable [0. 
To enable P30 and P37 for serial 1/0, bit 6 of P3M (F7H) is 
set. To enable odd parity, bit 7 of P3M is set; to disable it, 
the bit is reset. For example, the instruction: 
LD P3M,#40H 
will enable serial I/O, but disable parity. The instruction: 
LD P3M,#0COH 
will enable serial I/O, and enable odd parity. 
In the following discussions, bitrate refers to all transmitted 


bits, including start, stop, and parity (ifenabled). The serial 
bit rate is given by the equation: 


input clock frequency 
bit rate = (2x4xT0O prescaler x TO counter x 16) 


The final divide-by-16 is incurred for serial communica- 
tions, since in this mode TO runs at 16 times the bit rate in 
order to synchronize the data stream. To configure the Z8 
for a specific bit rate, appropriate values must first be 
selected for TO prescaler and TO counter by the above 
equation; these values are then programed into registers 
TO (F4H) and PREO (F5H) respectively. Note that PREO 
also controls the continuous vs. single-pass mode for TO; 
continuous mode should be selected for serial I/O. For 
example, given an input clock frequency of 7.3728 MHz 
and aselected bitrate of 9600 bits per second, the equation 
is satisfied by TO counter = 2 and prescaler = 3. The 
following code sequence will configure the TO counter and 
TO prescaler registers: 


LD T0,#02H !TO counter = 2! 

LD PREO,#00001101B 
Ibit 2-7 prescaler = 3; bitO 
continuous mode! 


Interruptrequest3 (IRQ3) is generated whenever a charac- 
ter is transferred into the receive buffer; interrupt request 4 
(IRQ4) is generated whenever a character is transferred 
out of the transmit buffer. Before accepting such interrupt 
requests, the Interrupt Mask, Request, and Priority Regis- 
ters (IMR, IRQ, and IPR) must be programmed to configure 
the mode of interrupt response. The section on Interrupt 
Processing provides a discussion of interrupt configura- 
tions. 
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To load and enable TO, set bits O and 1 of the timer mode 
register (TMR) via an instruction such as 

OR TMR,#03H 
This will cause the TO prescaler and counter registers 
(PREO and TO) to be transferred to the TO prescaler and 


counter. In addition, TO is enabled to count, and serial I/O 
operations will commence. 


Characters to be output to the serial line should be written 
to serial 1/O register SIO (FOH). IRQ4 will be generated 
when all bits have been transferred out. 
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Characters input from the serial line may be read from SIO. 
IRQ3 will be generated when a full character has been 
transferred into SIO. 


The following module illustrates the receipt of a character 
and its immediate echo back to the serialline. Itis assumed 
thatthe Z8® has been configured for serial 1/O as described 
above, with IRQ3 (receive) enabled to interrupt, and IRQ4 
(transmit) configured to be polled. The received character 
is stored in a circular buffer in register memory from 
address 42H to 5FH. Register 41H contains the address of 
the next available buffer position and should have been 
initialized by some earlier routine to 42H. 


Z8ASM 2.0 
LOC OBJ CODE STMT SOURCE STATEMENT 
1 SERIAL_IO MODULE 
2 CONSTANT 
3 next_addr = 41H 
4 start = 42H 
5 length = 1EH 
6 $SECTION PROGRAM 
7 GLOBAL 
8 'IRQ3 vector! 
9 $ABS 6 
P 0006 000’ 10 IRQ_3 ARRAY [1 WORD]= [GET_CHARACTER] 
11 
12 $REL O 
P 0000 13 GET_CHARACTER PROCEDURE ENTRY 
14 
15 !Serial 1/O receive interrupt service! 
16 !Echo received character and wait for 
17 echocompletion! 
P 0000 E4 FO FO 18 ld SIO,SIO lecho! 
19 
20 !Save it in circular buffer! 
P 0003 F5 FO 41 21 Id @next_addr,SIO !save in buffer! 
P 0006 20 41 22 inc next_addr {Point to next position! 
P 0008 A6 41 60 23 cp next_addr,#start+length 
24 !Wrap-around yet?! 
P OOOB EB 03 25 jr ne,echo_wait !No.! 
P OOOD E6 41 42 26 ld next_addr,#start!Yes. Point to start! 
27 INow, wait for echo complete! 
28 echo_wait 
P 0010 66 FA 10 29 tcm IRQ,#10H ITransmitted yet?! 
P 0013 EB FB 30 jr nz,echo_wait !Not yet! 
31 
P 0015 56 FA EF 32 and IRQ,#0EFH iClear IRQ4! 
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P 0018 BF 33 
P 0019 34 
35 END SERIAL_IO 


IRET 


O ERRORS 
ASSEMBLY COMPLETE 


10 instructions 
25 bytes 


END GET_CHARACTER 
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!Return from interrupt! 


35.5 us + 5.5 us for each additional pass through the echo_wait loop, including interrupt response time 


13.15.2 Automatic Bit-Rate Detection 


In a typical system, where serial communication is re- 
quired (in other words, a system with a terminal), the 
desired bit rate is either user-selectable via a switch bank 
or nonvariable and “hard-coded” in the software. As an 
alternate method of bit-rate detection, it is possible to 
automatically determine the bit rate of serial data received 
by measuring the length of astart bit. The advantage of this 
method is that it places no requirements on the hardware 
design for this function and provides a convenient (auto- 
matic) operator interface. 


In the technique described here, the serial channel of the 
Z8® is initialized to expect a bit rate of 19,200 bits per 
second. The number of bits (n) received through Port pin 
P30 for each bit transmitted is expressed by: 

n= 19,200/b 


where b = transmission bit rate. For example, if the 
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transmission bit rate were 1200 bits per second, each 
incoming bit would appear to the receiving serial line as 
19,200/1200 or 16 bits. 


The following example is capable of distinguishing be- 
tween the bit rates shown in Table 13-6 and assumes an 
input clock frequency of 7.3728 MHz, a TO prescaler of 3, 
XTAL/2 mode, and serial I/O enabled with parity disabled. 
This example requires that a character with its low order bit 
= 1(suchas acarriage return) be sentto the serial channel. 
The start bit of this character can be measured by counting 
the number of zero bits collected before the low order 1 bit. 
The number of zero bits actually collected into data bits by 
the serial channel is less than n (as given in the above 
equation), due to the detection of start and stop bits. 
Figure 13-4 illustrates the collection (at 19,200 bits per 
second) of a zero bit transmitted to the Z8 at 1,200 bits per 
second. Notice that only 13 of the 16 zero bits received are 
collected as data bits. 


> 
NV 
B 


Table 13-6. Inputs to the Automatic Bit Rate Detection Algorithm 
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Number of Bits Received Number of Bits Collected 
Bit Rate Per Bit Transmitted as Data Bits T, Counter 
dec binary dec binary 
19200 1 0 O0000000 1 00000001 
9600 2 1 00000001 2 00000010 
4800 4 3 0000001 1 4 00000100 1 
2400 8 7 00000111 8 00001000 
1200 16 13 00001101 16 00010000 
600 32 25 00011001 32 00100000 
300 64 49 00110001 64 01000000 
150 128 97 01100001 128 10000000 





}~+————— 1 Bit Time at 1,200 Bits Per Second —————_-» 


ST = Start Bit Sp = Stop Bit Dn = Data Bitn 


Each Interval Shown = 1 Bit Time 
At 19,200 Bits Per Second 


Figure 13-4. Collection of a Start Bit Transmitted at 19.2 KBps 
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Once the number of zero bits in the start bit has been 
collected and counted, it remains to translate this count 
into the appropriate TO counter value and program that 
value into TO (F4H). The patterns shown in the two binary 
columns of Table 13-6 are utilized in the algorithm for this 
translation. 


As a final step, if incoming data is to commence immedi- 
ately, it is advisable to wait until the remainder of the 
current ‘elongated’ character has been received, thus 
‘flushing’ the serial line. This can be accomplished either 
via a software loop; or by programming T1 to generate 


Z8ASM 2.0 
STMT SOURCE STATEMENT 


1 BITLRATE MODULE 
2 EXTERNAL 


LOC OBJ CODE 
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an interrupt request after the appropriate amount of time 
has elapsed. Since a character is composed of eight bits 
plus a minimum of one stop bit following the start bit, the 
length of time to delay may be expressed as: 


(9xn)/b 
where n and b are as defined above. The following module 


illustrates a sample program for automatic bit rate detec- 
tion. 


3 DELAY PROCEDURE 


4 GLOBAL 
P 0000 5 main PROCEDURE 
6 ENTRY 
P 0000 8F 7 di {Disable interrupts! 
P 0001 56 FB 77 8 and IMR, #77H 'IRQ3 polled mode! 
P 0004 56 FA F7 9 and IRQ,#0F7H IClear IRQ3! 
P 0007 E6 F7 40 10 ld P3M,#40H !Enable serial |/O! 
P QO0A E6 F4 01 11 Id T0,#01H 
p OOOD E6 F5 OD 12 ld PREO,#(3 SHL 2)+1 !bit rate = 19,200; 
13 continuous count mode! 
P 0010 BO EO 14 clr RO Init. zero byte counter! 
P 0012 E6 F1 03 15 Id TMR#03H !Load and enable TO! 
16 
17 !Collect input bytes by counting the number of null 
18 characters received. Stop when non-zero byte received! 
19 collect: 
P0015 76 FA08 20 tm IRQ,#08H !Character received?! 
P 0018 6B FB 21 jr Z,collect INot yet! 
P QO1A 18 FO 22 Id R1,SIO !Getthe character! 
P 001C 56 FA F7 23 and IRQ,#0F7H !Clear interrupt request! 
P OO1F 1E 24 inc R1 !Compare to O...! 
P 0020 1A 05 25 djnz_ __R1,bitloop !...(IN 3 bytes of code)! 
P 0022 06 EO 08 26 add RO,#08H !Update count of 0 bits! 
P 0025 8B EE 27 jr collect 
28 bitloop: {Add in zero bits from low 
29 end of 1st non-zero byte! 
P 0027 E0 E1 30 RR R1 
P 0029 7B 03 31 jr c,count_done 
P 002B OE 32 inc RO 
P 002C 8B F9 33 jr bitloop 
34 
35 {RO has number of zero bits collected! 
36 !Translate RO to the appropriate TO counter value! 
37 count_done !RO has count of zero bits! 
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P O002E 1C 07 38 ld R1,#07H 

P 0030 2C 80 39 ld R2,#80H 

P 0032 90 EO 40 RL RO 
41 

P 0034 90 EO 42 loop: RL RO 

P 0036 7B 04 43 jr c,done 

P 0038 EO E2 44 RR R2 

P 003A 1A F8 45 djnz__—ri,loop 
46 

P 003C 29 F4 47 done ld TO,R2 
48 
49 

P O003E D6 0000* 50 call DELAY 
51 

P 0041 56 FA F7 52 and IRQ, #0F7H 
53 

P 0044 54 END main 
55 END _ bit_rate 

O ERRORS 

ASSEMBLY COMPLETE 

30 instructions 

68 bytes 

Execution time is variable based on transmission bit rate. 

13.15.3 Port Handshake 


Each of Ports 0, 1 and 2 may be programmed to function 
under input or output handshake control. Table 13-7 de- 
fines the port bits used for handshaking and the mode bit 
settings required to select handshaking. To input data 
under handshake control, the Z8® should read the input 
port when the DAV input goes Low (signifying that data is 
available from the attached device). To output data under 
handshake control, the Z8 should write the output port 
when the RDY input goes Low (signifying that the previ- 
ously outout data has been accepted by the attached 
device). Interrupt requests IRQO, IRQ1, and IRQ2 are 
generated by the falling edge of the handshake signal 
input to the Z8 for Port 0, Port 1, and Port 2 respectively. 
Port handshake operations may therefore be processed 
under interrupt control. 


Consider a system that requires communication of eight 
parallel bits of data under handshake control from the Z8 to 
a peripheral device and that Port 2 is selected as the output 
port. The following assembly code illustrates the proper 
sequence for initializing Port 2 for output handshake. 


CLR P2M — !Port2moderegister all Port2 bits 
are outputs! 
OR 03H,#40H 


!Iset DAV2 data not available! 
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{R2 will have TO counter value! 


{Load value for detected 
bit rate! 
!Delay long enough to clear serial line of bit stream! 


!Clear receive interrupt request! 


LD P3M,#20H 


!Port 3 mode register enable 
Port 2 handshake! 


LD 02H,DATA 


output first data byte; DAV2 will 
be cleared by the Z8 to indicate 
data available to the peripheral 
device! 


Note that following the initialization of the output sequence, 
the software outputs the first data byte without regard tothe 
state of the RDY2 input; the Z8 will automatically hold DAV2 
High until the RDY2 input is High. The peripheral device 
should force the Z8 RDY2 input line Low after it has latched 
the data in response to a Low on DAV2._The Lowon RDY2 
will cause the Z8 to automatically force DAV2 High until the 
next byte is output. Subsequent bytes should be output in 
response to interrupt request |RQ2 (caused by the High- 
to-Low transition on RDY2) in either a polled or an enabled 
interrupt mode. 
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Input handshake lines 
Output handshake lines 


To select input handshake 


To select output handshake 


To enable handshake 


13-36 


Table 13-7. Port Handshake Selection 


Port 0 


P32 = DAV 
P35 = RDY 


P32 = RDY 
P35 = DAV 


set bit 6 & reset bit 7 of 
PO1M (program high 
nibble as input) 


set bits 6, 7 of POIM 
(program high nibble 
as output) 


set bit 5 of Port 3 (P3,); 
set bit 2 of P3M 


Port 1 


P33 = DAV 
P34 = RDY 


P33 = RDY 
P34 = DAV 


set bit 3 & reset bit 4 of 
PO1M (program byte as 
input) 


set bit 3, 40f PO1M 
(program byte as output) 


set bit 4 of Port 3 (P3,); 
set bits 3, 4 of P3M 
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Port 2 


P31 = DAV 
P36 = RDY 


P31 = RDY 
P36 = DAV 


set bit 7 of P2M 
(program high bit 
as input) 


set bit 7 of P2M 
(program high bit 
as output) 


set bit 6 of Port 3 (P3,); 
set bit 5 of PSM 
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13.16 ARITHMETIC ROUTINES 

This section gives examples of the arithmetic and rotate 
instructions for use in multiplication, division, conversion, 
and BCD arithmetic algorithms. 

13.16.1 Binary to Hex ASCII 

The following module illustrates the use of the ADD and 


SWAP arithmetic instructions in the conversion of a 16-bit 
binary number to its hexadecimal ASCII representation. 


Bit Do D7 
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The 16-bit number is viewed as a string of four nibbles and 
is processed one nibble at a time from left to right, begin- 
ning with the high-order nibble of the lower memory ad- 
dress. 30H is added to each nibble if it is in the range 0 to 
9; otherwise 37H is added. In this way, OOH is converted 
to 30H, 1H to 31H, ... OAH to 41H, ... OFH to 46H. Figure 13- 
5 illustrates the conversion of RRO (contents = F2BEH) to 
its hex ASCII equivalent; the destination buffer is pointed 
to by RR4. 


Pe 


Register 


Do 07 


Do D7 Do D7 


w— Ce Dee EE 


Figure 13-5. Conversion of (RRO) To Hex ASCIil 


Z8ASM 2.99 INTERNAL RELEASE 
LOC OBJCODE STMT SOURCE STATEMENT 
1 ARITH MODULE 


GLOBAL 
P 0000 3 BINASC PROCEDURE 
4 | KEKKKKEEKEKKEEKEEKEEEEKERKEKEKEERKEEREREKKKEKEREKKKEES 
5 Purpose = To convert a 16-bit binary 
6 number to Hex ASCII 
7 
8 Input= RRO = 16-bit binary number. 
9 RR4 = pointer to destination 
10 buffer in external memory. 
11 
12 Output = Resulting ASCII string (4 bytes) 
13 in destination buffer. 
14 RR4 incremented by 4. 
15 RO, R2, R6 destroyed. 
1 6 RASSEASARAR ERLE S EAN eR ee ene Sees 
17 ENTRY 
18 
P 0000 6C 04 19 ld R6,#04H !Inibble count! 
P 0002 FO EO 20 again: SWAP RO llook at next nibble! 
P 0004 28 EO 21 ld R2,RO 
P 0006 56 E2 OF 22 and R2,#0FH lisolate 4 bits! 
23 Iconvert to ASCII R2 + #30H if RO in range 0 
to9 
24 else R2 + #37H (in range OA to OF)! 
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P 0009 06 E2 30 26 ADD R2,#30H 
P OO0C AG E2 3A 27 cp R2,4#3AH 
P OOOF 7B 03 28 jr ult, skip 
P 0011 06 E2 07 29 ADD _ RS,#07H 
P 0014 92 24 30 skip: Ide @RR4,R2 !save ASCII in buffer! 
P 0016 AO E4 31 incw RR4 {point to next 
32 buffer position! 
P 0018 AG E6 03 33 cp R6,#03H Itime for second byte?! 
P 001B EB 02 34 jr ne,same_byte Ino.! 
P 001D 08 E1 35 ld RO,R1 !2nd byte! 
36 same_byte: 
P OO1F 6A E1 37 djnz  R6,again 
P 0021 AF 38 ret 
P 0022 39 END BINASC 


40 END ARITH 


0 ERRORS 

ASSEMBLY COMPLETE 
16 instructions 

34 bytes 

120.5 us (average) 


13.16.2 BCD Addition 


The following module illustrates the use of the add with _ significant digit in bits 7-4. Bytes within a BCD string are 
carry (ADC) and decimal adjust (DA) instructions for the  arrangedinmemory with the most significant digits stored 
addition of two unsigned BCD strings of equal length. __ in the lowest memory location. Figure 13-6 illustrates the 
Within a BCD string, each nibble represents a decimal _—_ representation of 5970 in a 6-digit BCD string, starting in 
digit (0-9). Two such digits are packed per byte with the _— register 33H. 


most 
Bit D7 43 Do 07 4 3 Do D7 4 3 Do 
(7 te 

Register %33 %34 %35 


Figure 13-6. Unsigned BCD Representation 
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Z8ASM 2.0 
LOC OBJ CODE STMT SOURCE STATEMENT 


1 ARITH MODULE 
2 CONSTANT 
3 BCD_SRC = Ri 
4 BCD_DST = RO 
5 BCD_LEN= R2 
6 GLOBAL 
P 0000 7 BCADDPROCEDURE 
8 EAE CEEE REAERREAAW ENE EARNER RENAN CRO e NT eRe Tee 
9 Purpose = To add two paced BCD strings of 
10 equal length. 
11 dst <— dst + src 
12 
13 Input= RO = pointer to dst BCD string. 
14 R1 = pointer to src BCD string. 
15 R2 = byte count in BCD string 
16 (digit count = (R2)*2 ). 
17 
18 Output = BCD string pointed to by RO is 
19 the sum. 
20 Carry FLAG = 1 if overflow. 
21 RO , R1 as on entry. 
22 R2=0 
23 EAES ELE RTE R SR Gn e e e ee one ee eT 
24 ENTRY 
25 
P 0000 02 12 26 add BCD_SRC,BCD_LEN !start at least...! 
P 0002 02 02 27 add BCD_DST,BCD_LEN Isignificant digits! 
P 0004 CF 28 rcf Icarry =O! 
29 add_again: 
P 0005 00 E71 30 dec BCD_SRC !point to next two 
31 src digits! 
P 0007 00 EO 32 dec BCD_DST {point to next two 
33 dst digits! 
P 0009 E3 31 34 ld R3,@BCD_SRC !Igetsrc digits! 
P OOOB 13 30 35 ADC R3,@BCD_DST ladd dst digits! 
P OO0D 40 E3 36 DA R3 !decimal adjust! 
P QOOF F3 03 37 Id @BCD_DST,R3 Imove to dst! 
P 0011 2A F2 38 djnz BCD_LEN,add_again loop for next 
39 digits! 
P 0013 AF 40 ret lalldone! 
41 
P 0014 42 END BCADD 
43 END  ARITH 
0 ERRORS 


ASSEMBLY COMPLETE 

11 instructions 

20 bytes 

Execution time is a function of the number of bytes (n) in input BCD string: 20 us + 12.5(n-1) us 
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13.16.3 Multiply 


The following module illustrates an efficient algorithm for 
the multiplication of two unsigned 8-bit values, resulting in 
a 16-bit product. The algorithm repetitively shifts the multi- 
plicand right (using RRC), with the low-order bit being 
shifted out (into the carry flag). If a one is shifted out, the 
multiplier is added to the high-order byte of the partial 


Z8ASM 2.99 INTERNAL RELEASE 
LOC OBJ CODE STMT SOURCE STATEMENT 
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product. As the high-order bits of the multiplicand are 
vacated by the shift, the resulting partial-product bits are 
rotated in. Thus, the multiplicand and the low byte of the 
productoccupy the same byte, which saves register space, 
code, and execution time. 


1 ARITH MODULE 
2 CONSTANT 
3 MULTIPLIER =Ri1 
4 PRODUCT_LO = R3 
5 PRODUCT_HI = R2 
6 COUNT = RO 
7 GLOBAL 
P 0000 8 MULT PROCEDURE 
Sia ae a alain blalel 
10 Purpose = To perform an 8-bit by 8-bit unsigned 
11 binary multiplication. 
12 
13 Input= Ri = multiplier 
14 R3 = multiplicand 
15 
16 Output = RR2 = product 
17 RO destroyed 
1 8 PREESALEAARE SEAR AC AERO RS ARE EET EA EERNE ER AAERE ES 
19 ENTRY 
P 0000 OC 09 20 ld COUNT,#09H 18 BITS + 1! 
P 0002 BO E2 21 clr PRODUCT_HI lINIT HIGH RESULT BYTE! 
P 0004 CF 22 RCF ICARRY =0! 
P 0005 CO E2 23 LOOP: RRC PRODUCT_HI 
P 0007 CO E3 24 RRC PRODUCT_LO 
P 0009 FB 02 25 jr NC,NEXT 
P QOOB 02 21 26 ADD PRODUCT_HI,MULTIPLIER 
P QOOD OA Fé 27 NEXT: djnz COUNT,LOOP 
P OOOF AF 28 ret 
P 0010 29 END MULT 
| 30 END ARITH 
0 ERRORS 


ASSEMBLY COMPLETE 
9 instructions 

16 bytes 

92.5 us (average) 
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13.16.4 Divide 


The following module illustrates an efficient algorithm for 
the division of a 16-bit unsigned value by an 8-bit unsigned 
value, resulting in an 8-bit unsigned quotient. The algo- 
rithm repetitively shifts the dividend left (via RLC). If the 
high-order bit shifted out is a one or if the resulting high- 
order dividend byte is greater than or equal to the divisor, 


Z8ASM 2.0 
LOC OBJ CODE STMT SOURCE STATEMENT 


1 ARITH MODULE 
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the divisor is subtracted from the high byte of the dividend. 
As the low-order bits of the dividend are vacated by the shift 
left, the resulting partial-quotient bits are rotated in. Thus, 
the quotient and the low byte of the dividend occupy the 
same byte, which saves register space, code, and execu- 
tion time. 


CONSTANT 
3 COUNT = RO 
4 DIVISOR = R11 
5 DIVIDEND_HI = R2 
6 DIVIDEND_LO = R3 
7 GLOBAL 
P 0000 8 DIVIDE PROCEDURE 
9 | KHAKI KKK KK KEKEKKKKEKEKEKEKEKKKKKEREEEKKKKKKK KKK 
10 Purpose = To perform a 16-bit by 8-bit unsigned 
11 binary division. 
12 
13 Input = R1 = 8-bit divisor 
14 RR2 = 16-bit dividend 
15 
16 Output = R3 = 8-bit quotient 
17 R2 = 8-bit remainder 
18 Carry flag = 1 if overflow 
19 = 0 if no overflow 
20 Se ene een Tee ee he nT ee ee ene eee 
21 ENTRY 
P 0000 OC 08 22 ld COUNT,#08H {LOOP COUNTER! 
23 
24 ICHECK IF RESULT WILL FIT IN 8 BITS! 
P 0002 A2 12 25 cp DIVISOR,DIVIDEND_HI 
P 0004 BB 02 26 jr UGT,LOOP ICARRY = 0 (FOR RLC)! 
27 IWON'T FIT. OVERFLOW! 
P 0006 DF 28 SCF ICARRY = 1! 
P 0007 AF 29 ret 
30 
31 LOOP !RESULT WILL FIT. GO AHEAD WITH DIVISION! 
P 0008 10 E3 32 RLC DIVIDEND_LO IDIVIDEND * 2! 
P OOOA 10 E2 33 RLC DIVIDEND_HI 
P OOOC 7B 04 34 jr c,subt 
P OOOE A2 12 35 cp DIVISOR, DIVIDEND_HI 
P 0010 BB 03 36 jr UGT,next ICARRY = 0! 
P 0012 22 21 37 subt! SUB  DIVIDEND_HI,DIVISOR 
P 0014 DF 38 SCF ITO BE SHIFTED INTO RESULT! 
P 0015 OA F1 39 next: djnz COUNT,LOOP Ino flags affected! 
40 
41 [ALL DONE! 
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P0017 10 E3 42 RLC DIVIDEND_LO 

43 ICARRY= 0 no overflow! 
P 0019 AF 44 ret 
P OO1A 45 END DIVIDE 


46 END ARITH 


O ERRORS 

ASSEMBLY COMPLETE 
15 instructions 

26 bytes 

124.5 us (average) 


13.17 Conclusion 


This section has focused on ways in which the Z8® micro- greater advantage. The major features of the Z8 have 
computer can easily yet effectively solve various applica- | been described so that the user can continue to expand 
tion problems. In particular, the many sample routines | and explore the repertoire of uses for the Z8. 

illustrated here should aid the user in applying the Z8 to 
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CHAPTER 14 
THIRD-PARTY SUPPORT TOOLS 


In addition to Zilog tool offerings, an extensive list of third party suppliers offer a variety of software (XASM, C Compilers, 


Simulators/Debuggers), hardware emulator, and OTP programmer (single and gang) products. 


14.1 Third-Party Support—Emulators/ 14.2 Third-Party Support—Assemblers/C 
Programmers Compilers 

Data I/O (OTP Programmer) (800) 332-8246 _ 2500AD Software (719) 395-8683 
EmulationTechnologies (408) 982-0660 _ Avocer Systems (800) 448-8500 
(OTP Socket Adapters) 

ByteCraft (519) 888-691 1 
iSystems (49) 8131-25085 

Micro Computer Control (609) 466-1751 
Logical Devices, Inc. (800) 331-7766 
(OTP Programmer) Production Languages Corp. (817) 599-8363 
Needham Electronics (916) 924-8037. Pseudo Corp. (503) 683-9173 
(OTP Programmer) 
Orion Instruments (408) 747-0440 
Signum Systems (805) 371-4608 
Systems General (408) 263-6667 
(OTP Programmer) 
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Overview 


CHAPTER 1 
OVERVIEW 


1.1 INTRODUCTION Zilog's Super8/Z8 Cross-Assembler (asmS8) takes a 
source file containing assembly language statements and 
translates it into a corresponding object file. It can 
produce a listing containing the source code, object 
code, and comments. The assembler supports macros and 
conditional assembly. It is written in C and runs on 
the UNIX operating system. Figure 1-1 illustrates the 
development path of a typical program. 
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Figure 1-1, asmS8 Program Development Cycle 
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1.1 INTRODUCTION 
(Continued) 


1.2 ASSEMBLER 
OVERVIEW 


1.2.1 Assembler 
Enhancements 


1.2.2 Modules 


The assembler can produce relocatable and absolute 
object code. Object files can contain a mixture of 
absolute and relocatable code. Object files then can 
be linked with other object files and loaded into 
memory . 


For a description of the architecture of the Super8 
family of microcomputers, refer to the Super8 Technical 
Manual. For a description of the architecture of the 
Z8 family, refer to the 2Z8 Microcomputer Technical 
Manual. 


The asmS8 Cross-Assembler is a macro assembler, written 
in C, that runs on the UNIX operating system for the 
DEC VAX and VMS, IBM-PC, and Zilog System 8000. The 
assembler produces output in a universal object code 
format (refer to the Universal Object Files Utilities 
User's Guide). 


Providing more than compatibility with existing hard- 
ware and software, the asmS8 assembler includes new 
features not available in earlier assemblers. Integer 
arithmetic on numbers up to 80 bits long is supported, 
as is arbitrary integer arithmetic on external and 
relocatable symbols. Additional expression opera- 
tors are defined, and syntax rules for expressions and 
operand delimiters have fewer restrictions. 


The asmS8 assembler increases support for constants by 
providing floating-point constants in addition to those 
numbers supported in the C _ language. However, 
floating-point arithmetic in assembly-time expressions 
is not supported. 


A program consists of one or more separately coded and 
assembled modules. Modules are referred to as either 
source modules or object modules. 


A source module is made up of assembly language 
statements. These statements are then translated by 
the asmS8 assembler into an object module that can 
either be separately executed by the Super8 (or Z8) 
microprocessor, or linked with other object modules to 
form a complete program. The user can also control the 
operation of the. assembler by including assembler 
directives, or "“pseudo-ops," in the source code. 
Briefly, pseudo-ops resemble opcodes in form, but not 
function (see Chapter 3). 


Depending on the assembler directives used, addresses 


within an object module or program can be absolute 
(addresses in the source program correspond exactly to 
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1.3 RELOCATION AND 
LINKING 


logical memory addresses) or relocatable (addresses can 
be assigned relative to a logical base address at a 
later time). Object modules should be made relocat- 
able whenever possible. This facilitates the ability 
to link with other object modules and also provides the 
ability to load object programs anywhere in memory. 
Relocatable addressing also allows the creation of 
libraries of commonly used procedures (including math 
or input/output routines) that can be linked selec- 
tively into several programs as desired. 


Relocation refers to the ability to bind a program 


module and its data to a particular memory area after 


the assembly process. The output of the assembler is 
an object module that contains enough information to 
allow the linker to assign that module to a memory 
area. Since many modules can be loaded together to 
form a complete program, a need for inter-module 
communication arises. For example, one module can 
contain a call to a routine that was assembled as part 
of another module and is located in some arbitrary part 
of memory. Therefore, the assembler must provide 
information in the object module that allows the linker 
to link inter-module references. 


There are several major advantages to using the 
relocating assembler as compared to an _ absolute 
assembler: 


1) Assignment of modules to memory areas can be 
handled by the linker rather than requiring the 
programmer to assign fixed absolute locations via 
the "ORG" pseudo-op; thus, modules can be relocated 
without requiring reassembly. 


2) If errors are found in one module, only that one 
module needs to be reassembled and relinked with 
the other modules, thus increasing § software 
productivity. 


3) Programs can be_ structured into independent 
modules, coded separately and assembled, even 
though other modules may not yet exist. 


4) Libraries of commonly used modules can be built and 
then linked with programs without requiring 
reassembly of the library module. 


5) Communications between overlay segments can be 
achieved through methods similar to normal 
(non-overlay) inter-module references. 


Unless otherwise specified, the output of the assembler 


is in relocatable form. During program execution, the 
instruction will be located at the memory location 
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1.35 RELOCATION AND 
LINKING 
(Cont inued) 


1.3.1 Inter-Module 
References 


1.3.2 Sections 


specified by the linker (assigned origin plus the 
relative offset). Thus, a relocatable module has its 
first instruction located at the memory location that 
is the assigned origin of the module as determined by 
the linker. 


To achieve relocation, addresses are altered at linkage 
time for both instructions that reference’ memory 
locations and data values that serve as pointers to 
memory locations. This process is transparent to the 
programmer. 


The asmS8 assembler supports two pseudo-ops (or pseudo 
operation codes), GLOBAL and EXTERNAL, so that 
instructions can refer to “names" (either data values 
or entry points) in other assembled modules. GLOBAL 
means that the listed names are defined in this module 
and are available for use by other modules. EXTERNAL 
means that the names are used in this module, but are 
defined in another module where they are declared to be 
global. The syntax requires one or more names to 
follow either pseudo-op. 


The GLOBAL name can be either absolute or relocatable. 
A portion of the object module contains a list of both 
the GLOBALs that are defined in the module, and the 
EXTERNALS that the module references. One function of 
the linker is to match all the EXTERNALS with the 
appropriate GLOBALS so that every instruction will 
reference the correct address during program execution. 


A more thorough discussion of pseudo-ops is given in 
Chapter 3. 


Programs can be divided into sections that are mapped 
into various areas of memory when linked or loaded for 
execution. A single module can contain’ several 
sections, each allocated to a different area in program 
or data memory. Likewise, portions of a section can be 
spread through several different modules and 
automatically combined into a single area by the 
linker. 


Sections provide the programmer with complete control 
over the memory mapping of a program without requiring 
absolute addressing. A module can contain some 
relocatable sections end some absolute sections, but s 
single section is either entirely absolute or entirely 
relocatable. Section 3.4.2 describes section definition 
in more detail. 
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2.1 INTRODUCTION 


2.2 SYMBOLIC NOTATION 


CHAPTER 2 
ASSEMBLY LANGUAGE SYNTAX 


The basic component of an asmS8 program is the assembly 
language statement. An assembly language statement can 
be up to 128 characters in length and is terminated by 
an end-of-line character. A statement can include four 
Fields: 


e Statement labels 

e An opcode 

e Operands 

e Comments 

A typical asmS8 statement might look like: 


LABEL1: LD R2,R5 3comment 


where LABEL1 is the statement label (signified by the 
colon), LD is the opcode, R2 is the destination 
operand, R5 is the source operand, and a comment is 
indicated by a semicolon. For compatibility with 
Zilog's Z8000 assembler, comments can begin with //, 
although this assembles slower. 


All fields are optional; label and comment fields can 
start in any column; the opcode and operands cannot 
start in column 1. The statement can have zero or more 
operands, depending on the opcode’ selected. The 
following sections describe conventions that must be 
observed in writing a program statement. 


Symbolic identifiers can include opcodes, pseudo-ops, 
special symbols, and labels. Legal identifiers can be 
up to 127 characters in length, and consist of one or 
more alphabetic characters, digits, or the characters: 
comma (,), dollar sign ($), question mark (7), period 
(.), at sign (@), or single quote mark ('). Upper and 
lower case letters are considered unique, and all 
characters are significant. 


The only restriction on symbols is that they cannot 
start with a digit or single quote mark ('). Since 
some older programs can rely on having only the first 
eight characters of a symbol being significant, 32 
global variable called $'SYMLEN is provided to limit 
the number of significant characters in a symbol. 
Appendix B describes global variables in more detail. 
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2.2.1 Labels Any statement that is referenced by another statement 
must be labeled, and any statement can contain one or 
more labels. A label is a symbolic identifier that can 
represent : 


An address (up to 16 bits) 

An 1/0 port 

A floating-point number 

Other quantities with up to 80 bits of significance. 


When a label is being defined, it can start in any 
column when immediately followed by a colon (:). If a 
colon is not used, the label must start in column 1. 
More than one label can be defined on the same line, 
for example: 


LABEL1: LABEL2: ... LABELn: statement 


A GLOBAL label can be declared by placing two colons 
after the label on the line where it is defined (e.g., 
LABEL1::). An EXTERNAL label can be declared by two 
pound signs that immediately follow (e.g., LABEL2##). 
A tilde (~) as the first character of a label makes it 
local to a block, as defined by the .BEGIN and .END 
pseudo-ops. 


A label definition preceded by a colon (:LABEL1) speci- 
fies that the data type of the label will be the same 
as the type generated by the rest of the statement. 
These labels can be checked across module boundaries. 


Labels for registers are given special treatment. 
Indexing is the only valid operation. Table 2-1 lists 
the Z8 System and Control register names. Table 2-2 
lists the Super8 system register names and Table 2-3 
lists the Super8 Mode and Control register names. 


The names of opcodes can be used freely as labels in 
the same assembly language statements. The assembler 
can recognize when a string is being used as an opcode 
rather than as a label. 


Decimal 
Address 


255 
254 
253 
252 
251 
250 
249 
248 | 
247 
246 
245 
244 
243 
242 
241 
240 
127-4 


3 
2 
1 
0 


Decimal 
Address 


222 
221 
220 
219 
218 
217 
216 
215 
214 
213 
212 
211 
210 
209 
208 
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Table 2-1. Z8 System and Control Registers 
Hexadecimal 
Address Register name 
FF Stack Pointer (bits 7-0) 
FE Stack Pointer (bits 15-8) 
FD Register Pointer 
FC Program Control Flags 
FB Interrupt Mask Register 
FA Interrupt Request Register 
F9 Interrupt Priority Register 
F8 Ports 0-1 Mode 
F7 Port 3 Mode 
F6 Port 2 Mode 
FS TO Prescaler 
F4 Timer/Counter 1 
F3 T1 Prescaler 
F2 Timer/Counter 1 
F 1 Timer Mode 
FO Serial 1/0 
7F-04 General-purpose registers 
03 Port 3 
02 Port 2 
01 Port 1 
00 Port 0 
Table 2-2. Super8 System Registers 
Hexadecimal 
Address Register name 
DE System mode 
DD Interrupt Mask Register 
DC Interrupt Request Register 
DB Instruction Pointer (Bits 7-0) 
DA Instruction Pointer (Bits 15-8) 
Dg Stack Pointer (Bits 7-0) 
D8 Stack Pointer (Bits 15-8) 
D7 Register Pointer 1 
D6 Register Pointer 0 
D5 Program Control Flags 
D4 Port 4 
D3 Port 3 
D2 Port 2 
D1 Port 17 
DO Port O 





Identifier 


SPL 
SPH 
RP 
FLAGS 
IMR 
IRQ 
IPR 


Identifier 


SYM 
IMR 
IRQ 
IPL 
IPH | 
SPL 
SPH 
RP 1 
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Table 2-3. Super8 Made and Control Registers 


Decimal Hexadecimal ‘Bank 
Address Address Number Register Name Identifier 
255 FF 0 Interrupt Priority IPR 
1 Wake-up Mask WUMSK 
254 FE 0 External Memory Timing EMT 
1 Wake-Up Match WUMCH 
253 FD 0 Port 2/38 Interrupt Pending P2BIP 
252 FC 0 Port 2/3A Interrupt Pending P2AIP 
251 PB 0 Port 2/3D Mode P2DM 
1 UART Mode 8B UMB 
250 FA 0 Port 2/3C Mode P2CM 
1 UART Mode A UMA 
249 F9 0 Port 2/3B Mode P2BM 
1 UART Baud Generator (bits 7-0) UBGL 
248 F8 0 Port 2/3A Mode P2AM 
4 UART Baud Generator (bits 15-8) UBGH 
247 F7 0 Port 4 Open Drain P40D 
246 F6 0 Port 4 Direction P4D 
245 F5 0 Handshake 1 Control HiC 
244 F4 0 Handshake 0 Control HOC 
241 F1 0 Port Mode , PM 
1 DMA Count (bits 7-0) DCL 
240 FO 0 Port O Mode POM 
1 DMA Count (bits 15-8) DCH 
239 EF ) UART Data UIO 
237 ED 0 UART Interrupt Enable UIE 
236 EC 0 UART Receive Control URC 
235 EB 0 UART Transmit Control UTC 
229 E5 0 CTR 1 Capture (bits 7-0) C1CL 
1 CIR 1 Time Constant (bits 7-0) C1TCL 
228 F4 0 CTR 1 Capture (bits 15-8) C1CH 
1 CTR 1 Time Constant (bits 15-8) C1TCH 
227 E3 0 CTR O Capture (bits 7-0) COcL 
1 CTR O Time Constant (bits 7-0) COTCL 
226 E2 0 CTR O Capture (bits 15-8) COCH 
1 CTR O Time Constant (bits 15-8) COTCH 
225 E1 0 CTR 4 Control CICT 
1 CTR 1 Mode C1M 
224 EO 0 CTR O Control COcT 
1 CTR O Mode COM 
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2.2.2 Condition Codes 


structions that take them. 


Condition codes are recognized only as operands of in- 
For example, the statement 


JR Z, Label 


causes Z to be treated as the condition code for zero. 


The condition codes and flag settings they represent 


are listed in Table 2-4, 








Table 2-4. 78 and Super8 Condition Codes 
Binary Mnemonic Meaning Flags Set 
0000 F Always False - 
1000 T Always True - 
0111 C Carry C=1 
1111 NC No Carry C=0 
0110 Z Zero Z=1 
1110 NZ Not Zero Z=0 
1101 PL Plus S=0 
0101 MI Minus S=1 
0100 OV Overflow V=1 
1100 NOV No Overflow V=0 
0110 EQ Equal Z=1 
1110 NE Not Equal Z=0 
1001 GE Greater than or equal (S XOR V) = O 
0001 LT Less than (S XOR V) = 1 
1010 GT Greater than (Z OR (S XOR V)) = O 
0010 LE Less than or equal (Z OR (S XOR V)) = 1 
1111 UGE Unsigned greater than or equal C=0 
0111 ULT Unsigned less than C=1 
1011 UGT Unsigned greater than (C = 0 ANDZ = 0) = 1 
0011 ULE Unsigned less than or equal (C OR Z) = 1 
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2.353 OPERATIONS AND 
OPERANDS 


2.4 COMMENTS 


An operation is a mnemonic that represents’ an 
instruction. 


The assembler also supports a restricted mode that 
handles only Z8 instructions. 


An operation in a program statement can be followed by 
one or more operands, which are general expressions 
separated by spaces or commas. Macro parameter lists 
are the only exceptions since they require parameters 
to be separated by commas only. Commas do not have the 
same effect as spaces because two commas in a row 
denote an omitted operand. A carriage return always 
serves as a statement delimiter. No more than one 
statement can be on singie line, and a single statement 
cannot span more than one line. 


An operand in a program statement can be: 
e Data to be processed (immediate data) 


e The designation of a location from which data is to 
be taken (source address) 


e The designation of a location where data is to be 
placed (destination address) 


e The address of 3 program location to which program 
control is to be passed 


e A condition code, used to direct program flow 


Although there are a number of valid combinations of 
operands, there is one basic convention to remember: 
the destination operand always precedes the source 
operand(s). Refer to the specific instructions in the 
appropriate (Super8 or Z8) Technical Manual for valid 
operand combinations, and for information about 
addressing modes. 


A comment is any string of characters following a 
semicolon (;) or two slashes (//) in a statement line. 
Comments have no functional effect on the assembly of a 
program--they are used only for documentation. 


Comments can start in any column of a line, and a 


statement can consist of only a comment. Comments 
terminate at the end of the line. 
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2.5 ARITHMETIC 
EXPRESSIONS 


2.6 EXPRESSIONS 
AND OPERATORS 
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The asmS8 assembler has a rich set of operators and 
expressions to handle arithmetic operations. This 
section first deals with specific formats for 
arithmetic statements, then follows with a discussion 
of constants and special symbols. 


Arithmetic expressions can be as long as 80 bits, and 
are examined from left to right. Precedence (order of 
evaluation) is as follows: 


e Operators and operands are accumulated. As soon as 
an operator is found that has a precedence level 
greater than or equal to the last operator 
encountered, all lower-precedence operations up to 
the new operator are performed. 


@® First prefix operations are performed, from right to 
left (inside out), then postfix and infix operations 
are performed from left to right. 


e Operands (labels and subexpressions in parentheses) 
are considered to be of precedence level O. 


The operators and their precedence (order of evalu- 
ation) are given in Table 2-5. The character "-" after 
the precedence means that the operation is not present 
in the Z8 assembler. The last column gives the PLZ/ASM 
equivalent, if there is one. 
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Table 2-5. Operations and Precedence 
Operator Function Precedence 
operand 
label 0 
const ant 0 
const ant 
Cee) Grouping 0 
prefix 
a Register indirect 1 
~ Declare local symbol 1 
post fix 
Hi Declare external 1 
prefix 
AHB High byte 2- 
ALB Low byte 2- 
AHW High word 2- 
ALW Low word 2- 
+ Unary plus 2 
- Unary minus 2 
AC 1's complement 2 
AB Binary-coded decimal 2 
A BYTE Byte (8 bit) 2~ 
A WORD Word (16 bit) 2- 
A LONG Long (32 bit) 2- 
“A QUAD Quad (64 bit) 2- 
A QUINT Quint (80 bit) 2- 
A ADDR Address (16 bit) 2- 
A REV Byte reverse 2- 
“A FWD Forward reference Z- 
A EXT External reference 2- 
infix 
ia Exponentiation 3- 
* Multiplication 4 
/ Division 4 
AMOD Modulo 4- 
A< Shift right 4 
> Shift left 4 


PLZ/ASM 


label 


Cece) 


LNOT 


MOD 
SHL 
SHR 
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Table 2-5. Operations and Precedence (Cont inued) 


Operator Function Precedence PLZ/ASM 
+ Addition 5 

- Subt ract ion 5 - 
ACAT String concatenation 5- 
A$ or A& Bitwise AND 6 LAND 
A| Bitwise OR 7 LOR 
AX Bitwise exclusive OR 7 LXOR 
= Equal 8- 

> Greater than 8- 

< Less than 8- 

= Greater than or equal  8- 

cs Less than or equal 8- 
AUGT Unsigned > 8- 
AULT Unsigned < 8- 

> Not equal 8- 
ASEQ Strings equal 8- 
ASNE Strings not equal 8- 

prefix 

Not-zero 9- 

infix 
&& Logical AND 9~ 

7 Logical OR 10- 

prefix 

# Immediate operand 11 
# 
post f ix 

adr{...] Indexing 11- 

adr(...) Indexing 11 a() 


Arithmetic is NOT DEFINED on floating-point values. 


The result of a test is zero if false, and all ones if 
true. For purposes of conditional assembly and logical 
operations, non-zero is considered to be TRUE. 


Parentheses can be used for grouping as well as to 
alter the predecedence of evaluation. 


Indexing (parentheses or square brackets) can be 
applied to strings to extract a particular character, 
or to addresses or offsets to denote’ indexed 
addressing. 
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2.7 


The type operators (like ABYTE) can be used to tell 
the assembler that a forward or extenna? reference will 
fit in a given size. 


The AFWD and “EXT operations return 1 if the value of 
their operand is forward-referenced or external; 
they otherwise return 0. 


There are no restrictions on the relocation modes of 
integer operands, since the linker can _ support 
arbitrary integer arithmetic on _ relocatable and 
external symbols. However, operations on strings 
cannot be passed to the linker. 


Some expression operators consist of multiple 


characters. There are three main forms, as shown in 
Table 2-6. 


Table 2-6. Expression Operators 





Form Example Description 

2? = Two punctuation characters 

aes a. "A" plus single punctuation character 
ay “FS "a" olus any number of letters 

id An identifier 





No identifiers are used as expression operators in the 
assembler as supplied. However, the user can define 
them to achieve compatibility with PLZ/ASM and other 
assemblers. 


CONSTANTS A constant value is one that doesn't change throughout 
the program. Constants can be expressed as numbers 
(integer and floating-point), character sequences, or 
as symbolic names representing a constant value. 
Constants supported by the assembler include integers, 
floating-point numbers, cheracters, and. character 
strings. 


Integers start with a digit (leading zero is 
sufficient) and can contain a base indicator: 


B Binary 

D, E ore Decimal 

H or X Hexadecimal 
0 or Q Octal 
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Permitted 
Characters 


2.8 LOCATION 
COUNTER 


-Fryn 3 DO 


“dd 
ddd 


This is an extension that was made to allow C-style 
constants. Base indicators and hexadecimal digits can 
be in any mixture of upper and lower case. The default 
value is decimal. 


In addition, the PLZ base-tag convention is supported: 


% Hexadecimal 
%(8) Octal 
%(2) Binary 


Floating-point numbers start with a digit and contain a 
decimal point. They can optionally contain the letter 
E or e followed by an optional sign and an exponent. 
Floating-point numbers are always in base 10. 


Characters and character strings are enclosed in single 
or double quotes. If an escape character is defined, 
C-type escape sequences are permitted. The escape 
character is the value of the special symbol $'STRESC. 
The characters permitted after the escape character and 
their meanings are noted in Table 2-7. 


Table 2-7. Escape Characters 


Meaning 


The string's quote character 
Newline (line feed) 

Carriage return 

Form feed 

Tab 

Backspace 

Single quote 

Double quote 

Backslash 

(2 hex digits)--arbitrary character 
(1-3 octal digits)--arbitrary character 


The number base of the digits form of escape is given 
by $'SBASE (default 8). 


The symbols ($) or (.) refer to the current value of 
the location counter (corresponding to the address 
where the first byte generated by the statement is 
loaded). Either one of these symbols can be used as an 
operand in any arithmetic expression (but their use 
does not imply the use of PC-relative addressing). The 
arithmetic expression is computed at assembly or link 
time. 


3.1 INTRODUCTION 


3e2 RELOCATION 
PSEUDO-OPS 


Assembly Language Pseudo-Ops 


CHAPTER 3 
PSEUDO-OPS 


The asmS8 assembler permits the use of pseudo-ops 
(pseudo operation codes). These pseudo-ops do not 
cause the assembler to generate object code, but rather 
specify actions to be taken by the assembler. Pseudo- 
ops use the same line format as standard instructions 
(label, opcode, operands, comments). Pseudo-ops can 
begin in any column except column 1. The pseudo-ops 
permitted by the asmS8 assembler are grouped by func- 
tion and are described in the following sections. 
Table 3-1 lists the pseudo-op abbreviations and their 
meanings. 


Table 3-1. Pseudo-Op Description Abbreviations 


Abbreviations Meaning 
n Numeric expression 
Ss String 
sn String or numeric expression 
d Decimal digit 
p Actual parameter (see note 1) 
f Formal parameter (see note 2) 
} Optional label, more than one 

Permitted 

1] Required label, one only 
? Optional 


Notes for Table 3-1: 


1. An actual parameter is a string enclosed by macro 
quotes (normally {...}) or any sequence of 
characters delimited by a comma, space (if $'BSEP 
is set), end-of-line, or semicolon. (Refer to 
$'MACBEG and $'MACEND in section 4.2.2). 


2. A formal parameter is either a label or an actual 


parameter that does not start with ae character that 
can denote a label. 


The following pseudo-ops are used to specify the 
relocation of code within memory. 
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3.2.1 Origin 


General Form: 
1 .ORG on 
Description: 


The .ORG pseudo-op sets the location counter to the 
value of the expression n. In specifying where the 
object code is located, the location counter serves the 
same function for the assembler as the Program Counter 
does for the CPU. 


The location counter is set to the value of the expres- 
sion, so that the next machine instruction or data item 
will be located at the specified address. The expres- 
sion must not contain any forward references, but can 
be relocatable. The location counter is initially set 
to zero, so if no .ORG statement precedes the first 
instruction or data byte in a section, that byte will 
be assembled at location zero (relative to the start of 
the section). Any label that is present will be assign- 
ed the same value as the expression. A module can 
contain any number of .ORG statements. 


The mode of the expression in an .ORG pseudo-op cannot 
be external and depends on the relocatability of the 
section. If a section is absolute, the .ORG pseudo-op 
serves to assign an absolute address to both the loca- 
tion counter and the label. In addition, any .ORG 
statement will also set the starting address of an 
absolute section when it immediately follows the 
eSECTION statement. 


In a relocatable section, the expression will be 
treated as any offset relative to the origin of the 
module. Thus the label on an .ORG statement in a 
relocatable module will have a relocatable mode. For 
example, the effect of the statement 


‘Label SUpcode Operand 
LAB: -ORG 100 


within a relocatable section would be to set the loca- 
tion counter to the beginning of the section plus 100, 
assign the label LAB’ the value 100, and make that 
label relocatable. A simply relocatable expression in 
an .ORG can be used to change to another section. 


Relocatable sections do not generally contain .ORG 
statements, since the pseudo-op is useful only to 
reserve space within the module (in a manner similar to 
the .DEFS pseudo-op). 
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3.2.2 Phase 


3.2.3 Dephase 


3.3 LABEL DEFINITION 
PSEUDO-OPS 


Example: 


START1: .ORG %10 3;Start section 1 at the hex 
saddress 10 


General Form: 
«PHASE n 
Description: 


The .PHASE pseudo-op assembles the code that follows to 
execute starting at address n. Labels will be defined 
as if an origin pseudo-op (.0RG) had been issued, but. 
the address into that code is not affected. This 
pseudo-op is provided for pieces of code that are going 
to be moved (for example, from ROM to RAM) before they 
are executed. 


Example: 


»~PHASE 500 


General Form: 
« DEPHASE 
Description: 


The .DEPHASE pseudo-op terminates the effect of a 
preceding .PHASE pseudo-op. 


Example: 


« DEPHASE 


Labels on instructions are automatically assigned the 
current value of the location counter. The pseudo-ops 
-EQU and .SET can be used to assign arbitrary values to 
symbols. To facilitate inter-module communication, 
certain symbols can be declared to be either .GLOBAL or 
-EXTERNAL to a particular module. .FQU and .SET re- 
quire that the expression have no forward references 
(it can contain previously declared external symbols). 
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3.3.1 Equate 


3.3.2 Set Re—-definable 
Label 


General Fora: 


1] .EQU in 
ll = n 
Description: 


The .EQU pseudo-op assigns the value of the expression 
nm to the symbol in the label field ll. The label 
cannot be redefined in. this source program. The 
expression can include a register or other addressing 
mode. 


Using symbolic names for constant values in place of 
numbers enhances the readability of a program and tends. 
to make the code self-documenting. For instance, the 
symbol BUFLEN is a more descriptive name for a value 
than just the number 72. Furthermore, if a value that 
is used throughout a program needs to be changed, the 
eEQU statement can simply be modified rather than 
finding all occurrences of the number 72. 


Example: 


TWO =. EQU 2 3;the symbol TWO now has 
3a value of 2 


General Form: 
ll .SET n 
Description: 


This pseudo-op assigns the value of the expression n to 
the symbol in the label field ll. The Jabel assignment 
can be changed using 2 subsequent .SET pseudo-op. The 
-SET pseudo-op is identical to the .EQU pseudo-op 
except that the assigned label can appear in multiple 
-SET pseudo-ops in the same program, 


In general, use the .EQU for symbol definition since 
the assembler will generate error messages  (ffor 
multiply-defined symbols. This can indicate spelling 
errors or some other oversight by the user. SET 
should be reserved for special cases where the same 
symbol is re-used (e.g., in conjunction with the 
assembly of macros). 


-EQU and .SET require that the expression have no 
forward references (it can have external symbols 
provided they have been declared previously). 


3.3.5 Define 
Arbitrary Symbol 


3.5.4 Global 


3.5.5 External 
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Example: 


COND1 .SET 150 sset initial value to 150 
COND1 .SET COND1 + 109 j;increment value by 100 


General Form: 

11 DEF 1 

Description: 

This pseudo-op defines the label 11 as an exact synonym 
for the operand symbol 1. Neither the label nor the 
operand needs to be an identifier; they may be 
punctuation characters such as + . If the label is 
non-alphabetic, it must be preceded by a colon. 
Example: 


AND .DEF A& 


STORE .DEF LD 


: | DEF A 


General Form: 

~GLOBAL 111,...1l1n 

Description: 

These pseudo-ops specify that each of their operands 
are symbols that are defined in the current module and 
that the name and value of each operand is made 
available to other modules that contain an .EXTERN 
declaration for any symbol. There can be one or more 
names separated by commas (or no names at all). 


-GLOBAL pseudo-ops can occur anywhere within the source 
text. 


Example: 


~GLOBAL ENTRYA, EXITA, ENTRYB, EXITB 


General Form: 

eEXTERN L11,...11n 

Description: 

This pseudo-op specifies that each of the operands are 
symbols that are defined in some other module, but are 
referenced in the current module. The syntax is the 


same as .GLOBAL. 
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3.3.9 External 
(Cont inued ) 


3.4 MODULE AND 
SECTION 
PSEUDO-OPS 


3.4.1 Module 
Definition 


3.4.2 Section 
Definition 


-EXTERN pseudo-ops can occur anywhere within the source 
text. The .EXTERN pseudo-op assigns each name an 
external mode, which allows the name to be used in 
arbitrary expressions elsewhere in the module, subject 
to the rules for external expressions. If an .EXTERN 
and a .GLOBAL definition for the same label appear in 
the same module, the .GLOBAL pseudo-op will take 
precedence. 


An external symbol can be assigned a value using either 
a .SET or .EQU pseudo-op. An assigned value will be 
the default value of a symbol if it is not resolved 
when the object module is linked. 


Example: 


EXTERN ENTRYA, EXITA, ENTRYB, EXITB 


The following pseudo-ops are used to name the object 
module, and to define specific areas of source code 
that can be relocated separately. 


General Form: 
eMODULE p p? 
Description: 


This pseudo-op defines the name of the module. If 
given, the second parameter becomes the target name in 
the object module. Otherwise, the target name will be 
"Z8" or "ZS8". The target name is a universal object 
file format field name for use by other programs such 
as a loader (see the Universal Object File Utilities 
User's Guide). 


There can be only one .MODULE statement in a module. 
If no .MODULE statement is given, the module takes the 


name of the source file with its extension (.s) 
deleted. 


Example: 


«MODULE Main ;Define main module 


General Form: 


1 .SECTION 11,...1n 
1 .PSEC  =-:14,.. In 
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Description: 


These pseudo-ops start a section. The first parameter 
is the name of the section, and can be null when 
terminated by a comma. Any other parameters are the 
universal object file attributes of the section (see 
the Universal Object Files Utilities User's Guide). 
When given, a statement label is defined as a pseudo-op 
that will direct assembly output to that section. 
Assembly can also be directed to the section by giving 
another .SECTION command with the same section name. 


The following section changing operations’ are 
predefined: 


Name Meaning 

-DATA Data section 
~CODE Code section 
-BSS BSS section 

-ABS Absolute section 
-CSEC Common section 


All of these direct: assembly to 3 section with the same 
name and appropriate attributes. The default section 
is a nameless and relocatable section; to return to the 


default section, use a .SECTION command with no 
perameters. 


The following operations enclose blocks of local 
symbols: 


Name Meaning 

«BEGIN Begin local symbol block 
Begin local symbol block 

END End local symbol block 

} End local symbol block 


Local symbols are defined with a tilde character "W" at 
the beginning. .BEGIN and { are synonymous, as are 
-END and }. Furthermore, blocks can be nested. 


Example: 


BEGIN 
L1: 

BEGIN 
Lis 

~END 

~END 
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3.4.2 Section 
Definition 
(Cont inued ) 


3.5 GENERAL DATA 
DEF INITIGN 
OPERATION 


3.5.1 Data Definition 


3.5.2 Sized Data 
Definition 





Note that a .END without a matching .BEGIN will mark 
the end of the source program (see section 3.7.1). 


Pseudo-ops are provided to define message, text, 
character string, and data size. 


General Form: 
1 .DD sni,...,snn 
or 
1 .DD repeat-count (data) 
Description: 


This pseudo-op assembles a2 list of data items. Any 
number of expressions or strings can be listed in a .DD 
statement. Each item listed is stored in its natural 
length: expressions involving addresses or forward 
references ere stored in 16-bit words, expressions with 
values less than 256 are stored in one 8-bit byte, and 
strings are stored “as is." 


Strings that are not used as numbers (no arithmetic 
operators are applied to them) are not affected by 
special symbols $'STRLEN and $'STRORD. Operators like 
-BYTE can be used to force an expression to an 
appropriate length. 


Example: 
DATA: .DD ZED+100 


~-DD “This is a string" 


General Form: 


1 .BYTE nil,...,An 
1] .WORD n1,...,¢NNn 
1 .LONG ni1,...,nn 
1 .QUAD nt,...,NN 
1 .QUINT ni,...,A0n 
1 .EXTEND n1,...,nn 
Description: 


These pseudo-ops define data of a specified size. Any 
number of expressions can be listed provided each fits 
within the specified data size. These pseudo-ops take 
each operand and generate object code of the size 
specified, locating the most significant byte at the 
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3.5.5 Define ASCII 
String 


3.5.4 Define ASCII 
String with 
Length 


3.9.2 Define ASCII 
String with 
Flagged Last 
Character 


current value of the location counter, and the next 
most significant byte at the next higher location. 


The mode of the expression can be either absolute, 
relocatable, or external. If present, a label will be 
assigned the address of the first data item. String 
arguments are always subject to the processing 
specified by $'SnLEN and $'SnORD (i.e., converted to 
numbers). 


Example: 

WORDS: .WORD 512,ABLE 

General Form: 

] .ASCII sni,...,snn 

Description: 

This pseudo-op defines message strings or byte data. A 
parameter can be either an expression or a string. Any 
number of parameters can be listed. An expression must 


fit into 2 single byte area; strings are _ stored 
completely. 


Examples: 
Label Opcode Operand 
MSG: ASCII "HELLO THERE'S, x+1 


General Form: 

1 .ASCIL s1,...,8n 

Description: 

This pseudo-op defines strings, with each string 
preceded by a byte containing its length. Parameters 
can also be expressions, each of which is also stored 
with a byte containing its length. 


Example: 


TXT: .ASCIL ‘'OPEN','CLOSE' 


General Form: 

l eASCIC Sl5.4449N 

This pseudo-op defines character’ strings. The 
high-order bit of the last character of each string is 


set to one (1); the high-order bits of all other 
characters in the string are set to zero (0). 
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3-3-2 Define ASCII 
String with 
Flagged Last 
Character 
(Cont inued) 


3.9.6 Define Null- 
Terminated ASCII 
Strings 


3.5.7 Reserve Space 


3.9.8 General Reserve 
Block 


Example: 


CHARS: .ASCIC ‘ABCD’, 'EFGH' 


General Fora: 


1 .ASCIZ s1,...,sn 


‘Description: 


This pseudo-op defines character strings with = an 
additional zero (null) byte at the end of each string. 


Example: 


label: ASCIZ 'S1',S2 


General Fora: 


1 .BLKB nn Reserve a block of bytes 

1 .BLKW n Reserve a block of words 

] .BLKL nn Reserve a block of longwords 

1 .BLKQ n Reserve 3 block of quadwords 

1 .BLKX nn Reserve a block of extended words 
Description: 


These pseudo-ops reserve space in differing word 
lengths. The operand n specifies the number of words 
to be reserved for data storage starting at the current 
value of the location counter. Except for .BLKB, these 
pseudo-ops are aligned on word boundaries. When 
present, a label will be assiqned the address of the 
first byte reserved. 


The expression can evaluate to any quantity; however, 
the mode must be absolute and not have forward 
references. Any symbol appearing in the expression 
must have been defined before the assembler encounters 
the expression. 

Example: 


label: .BLKW 5 


General Fora: 


1 .BLOCK n, n? 
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3.929 Alignment 


3.5.10 Even or Odd 
Alignment 


Description: 


This pseudo-op reserves n bytes of space in memory. 
One operand (n) specifies the number of bytes to be 
reserved for data storage starting at the current value 
of the location counter. When provided, the second 
operand is the alignment boundary for the block. Any 
label will be assigned the address of the first 
reserved byte. 


The expression can evaluate to any quantity, but the 
mode must be absolute and not have forward references. 
Any symbol appearing in the expression must be defined 
before the assembler encounters the expression. 


This pseudo-op reserves storage by incrementing the 
location counter by the value of the first expression, 
Since no object code is generated into the storage 
area, the contents of storage during initial program 
execution are unpredictable. 

Example: 


STORE: .BLOCK 512 


General Form: 
ALIGN n? 

Description: 

This pseudo-op aligns the next item on a multiple of n 
bytes. If the next statement is a .SECTION pseudo-op, 
the start of the section is aligned. If the parameter 
n is omitted, a word alignment default value of 2 is 
assumed. 


Example: 


FORMAT: .ALIGN 4 


General Fora: 


. ODD 


Description: 


These pseudo-ops align the next item on an even or odd 
boundary. 
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3.6 CONDITIONAL 
ASSEMBLY 
PSEUDO-OPS 


Conditional assembly permits the programmer to inhibit 
or enable the assembly of defined portions of the 
source code depending on the presence of a pre- 
determined condition. 


General Form: 


e Start Conditional Block 


~IF on 

e Separate True and False Conditional Blocks 
«ELSE 

e End Conditional Block 
ENDIF 

Description: 


IF defines the start of the conditional code block and 
tests for the true (non-zero) or false (zero) state of 
the expression n. .ELSE separates the code that is 
assembled if the expression is true from the code that 
is assembled if the condition is false (.ELSE is 
optional). .ENDIF defines the end of the conditional 
code block. Conditional blocks can be nested up to 80 
deep. 


The mode of the expression can be either relocatable or 
absolute. Forward or external expressions generate a 
warning, and are always considered to be true. 


Notice that the definition of symbols within a 
conditional assembly block can be inhibited, and thus 
references to these symbols elsewhere in the module can 
cause undefined symbol errors. In particular, the 
label on an .ELSE pseudo-op is part of the true block, 
and will not be defined if the assembly is inhibited on 
that portion of the program. 


Conditional assembly is particularly useful when a 
program needs to contain similar code sequences for 
slightly different applications. Rather than generating 
a multitude of pfograms to handle these situations, the 


‘application-dependent sections of code can be enclosed 


by the conditional pseudo-ops within a single program. 
Thus, the user generates different object modules from 
subsequent. assemblies of the same source by changing 
the values of several symbols used to control the 
conditional assembly. 


Another common use of conditional assembly is in 


conjunction with macros to control generation of code 
dependent on the value of parameters (see Chapter 4). 
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PSEUDO-OPS 


3.7.1 End Program 


3.7.2 Include 


Assembly Language Pseudo-Ops 


Example: 
IF FLAG 


. s;assembled if FLAG non-zero 


; sassembled if FLAG equals zero 


ENDIF 


Pseudo-ops are provided to: control the format of 
printed listings, control the information presented on 
the listings, control the printing of errors or warning 
messages, and to establish the compatibility mode of 
the assembler. 


General Form: 
1 .END nn? 
Description: 


This pseudo-op specifies the end of source code. Any 
expression is taken as the starting address of the 
program. The .END pseudo-op signifies the end of the 
source program, and thus any subsequent text will be 
ignored and will not appear in a listing. 


Any label will be assigned the current value of the 
location counter. Operands are ignored. If a source 
program does not contain an .END pseudo-op, then the 
end-of-file mark in the assembler command line will 
Signify the end of the program. 

Examples: 

EXIT: .END send of module 


eEND START 


General Form: 

-INCLUDE p 

Description: 

This pseudo-op includes the source file identified by 
the parameter (p) into the source stream immediately 
following this statement. The usual use of this 


statement is to include items such as files of macro 
definitions, lists of .EXTERNAL declarations, lists of 
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3./.2 Include 
(Cont inued ) 


3.7.5 Page Title 


3.7.4 Page Subtitle 


-EQU statements, or commonly used subroutines into the 
source stream. However, this pseudo-op can be used 
anywhere in a program. The file name given must follow 
the normal convention for specifying source file names. 


- INCLUDE pseudo-ops can be used in files specified in a 
preceding .INCLUDE pseudo-op. These pseudo-ops can be 
nested to a depth of four deep. If the .INCLUDE 
pseudo-op appears within a macro definition, the file 
will be included every time the macro is expanded. 
~ INCLUDE pseudo-ops can be used in conditionals. 
Example: 


~ INCLUDE FILE1 


General Form:X 

~TITLE pt,...pn 

Description: 

This pseudo-op causes the string specified in 
parameters to be printed at the top of each page of the 
listing. 

Example: 


-TITLE Program for Interest Calculation 


General Form: 

-SUBTTL p1,...pn 

Description: 

This pseudo-op prints strings specified in parameters 
on the second line of following pages in the listing. 
The subtitle on the first page of the listing will be 
the name of the source file. An outer layer of quotes 
will be ignored. 


Example: 


-SUBTTL Created by P. Jones 


3.7.5 Listing Control 
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General Form: 
e@ Control Listing 
~LIST op 
e Control Warning Listing 
-WLIST p 
e Control Conditional Listing 
-CLIST p 
@ Control Macro Listing 
MLIST p 
e Control Macro Object Listing 
-XLIST p 
Description: 
These pseudo-ops cause an output listing file to be 
generated according to the pseudo-op(s) used and the 


parameter given. 


The parameters given for each of the listing control 
pseudo-ops can be any one of the following symbols: 


Value Meaning 
ON Include in listing file. 
OFF Do not include in listing file. 
PUSH Save current value of pseudo-op control 


status in appropriate variable. 


POP Restore saved value of pseudo-op control 
status from appropriate variable. 


The variables $'LIST, $'WLIST, $'CLIST, $'MLIST, and 
$'XLIST are used as 80-bit pushdown stacks to store and 
recover the current state of the parameter given in 
their respective list control pseudo-op. The parameter 
state value is stored in the low-order bits of the 
variable. 


Pseudo-op .LIST with p=O0N enables a listing file of the 


source to be generated. When P=OFF, .LIST prevents a 
listing file from being generated. 
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3.7.5 Listing Control 
(Cont inued ) 


3.7.6 List Error 
Message 


3.7.7 List Warning 
Message 


Pseudo-op .WLIST with p=0N enables warning messages to 
be included in the listing file. When p=OFF, .WLIST 
prevents warning messages from being included in the 
listing file. 


Pseudo-op .CLIST with p=0N enables those portions of 
the source file that are conditionally skipped to be 
included in the listing file. When p=OFF, -CLIST 
prevents those "conditionally skipped" portions of the 
source file from being included in the listing file. 


Pseudo-op .MLIST with p=0N enables the expansion of 
macros to be included in the listing file. When 
p=0FF, -MLIST prevents macro expansions from being 
included in the listing file. 


_Pseudo-op .XLIST with p=0N enables the listing of 


binary object code to be included in the listing file. 
When p=OFF, .XLIST prevents these extra binary object 
lines from being included in the listing file. 


The default value for all listing control listings is 
p=ON. 


Example: 


«LIST ON 


General Form: 

eERROR s 

Description: 

This pseudo-op causes the message given in string (s) 
to be generated and sent to the terminal and _ the 
listing. 

Example: 

eERRGR ‘SYNTAX ERROR‘ 

General Form: 

-WARN s 

Description: 

This pseudo-op causes the warning message given in 
string (s) to be generated and sent to the standard 
output. 

Example: 


-WARN ‘POSSIBLE PROBLEM HERE ' 
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3.7.8 Start New Page 


3.7.9 Search Library 


3.7.10 Object File 
Comment 


General Form 
-PAGE nn 
Description: 


This pseudo-op causes the listing to be paginated. The 
page size is set at the value given inn. If nm is 
zeTO, the assembler will not paginate the listing. 
Page size is given in number of lines per page. 


The default action is not to paginate the listing, 
Since system utilities can be used for that purpose. 
~PAGE with no operand simply starts a new page in the 
listing, and is equivalent to a line containing a form 
feed. 

Example: 


-PAGE 66 ;set page size to 66 lines 


General Ff orm: 

1 LIBRARY p 11,...1n? 

Description: 

This pseudo-op puts a2 directive into the object file 
that instructs the linker to search a given library 
file (the first parameter) for the definitions of 
external symbols. If labels are given in_ the 
parameter(s), the library is searched only for those 
external labels. 

Example: 

eLIBRARY clib.a Subr1, Subr2, Subr3 


»LIBRARY xyzlib 


General Form 

eOCOMMENT n? s 

Description: 

This pseudo-op enters the text given in string (s) into 
the object file listing as a comment. Any value given 
for n is used as the “comment level" value. Comments 
below a link-time settable level will appear in load 
maps. 

Example: 


-OCOMMENT 3,'tables start here' 
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4.1 


GENERAL 
DESCRIPTION 


CHAPTER 4 
MACROS 


Macros provide a means for users to define their own 
opcodes or to redefine existing opcodes. A macro is a 
portion of a program invoked by its name. It begins 
and ends with pseudo-ops, and can contain any assembler 
constructs, including pseudo-ops and macros. Two types 
of macros can be used in asmS8 programs: MACROs and 
PROCs. 


MACROs are the familiar string substitution macros used 
in other assemblers. Parameter strings provided in the 
macro's invocation are substituted in the body of the 
macro. MACRO parameters must be separated by commas, 
and can contain blanks. 


PROCs are call-by-value, procedure-type macros. The 
parameters provided in the invocation statement are 
expressions, and their values are substituted into the 
body of the macro. As with ordinary opcodes, PROC 
parameters can contain blanks either before or after 
operators. Likewise, commas between expressions are 
optional. 


In general, a macro definition consists of the block of 
code beginning with a “start" pseudo-op and ending with 
an “end" pseudo-op. The statement containing the start 
pseudo-op requires a label. It serves as the name of 
the macro, and is used to invoke it. Each statement 
between the start and end statements is stored in the 
assembler's symbol table as the definition of the 
macro. These statements can include macro invocations 
and definitions. In addition, recursion is allowed. 


The statements of the macro body are not assembled at 
definition time. As a result, they do not define 
labels, generate code, or cause errors until the macro 
is invoked. Macros must be defined before they are 
invoked. 


A macro is invoked by using its name as an opcode at 
any point after the definition. Every macro definition 
has an implicit parameter named #$YM. This can be 
referenced by the user in the macro body, but should 
not explicitly appear in the .MACRO statement. 


Macros 


4.1 GENERAL 
DESCRIPTION 
(Cont inued) 

4.2 MACRO OR 
STRING MACRO 


4.2.1 MACRO Definition 


4.2.2 MACRO Special 
Symbols 


At expansion time, each occurrence of #$YM in the 
definition is replaced by a string representing a 4- 
digit hexadecimal constant. This string is constant 
over a given macro expansion. However, it increases by 
one for each macro invocation to avoid multiple 
definition errors. This provides unique labels for 
different expansions of the same parameter. 


MACRO is the string substitution macro. 


The general form of a MACRO definition is: 

1] .MACRO f1,...,fnm ;start MACRO pseudo-op. 
(statements that form body of MACRO) 
-ENDM ;end MACRO pseudo-op. 


The required label serves as the name of the MACRO, to 


‘be used on invocation. A formal parameter (f1,...,fn) 


can be either a label or a string of any characters 
except blanks, commas, or semicolons. Furthermore, 
parameters must start with a character that cannot 
start a label. Formal parameters that are labels are 
recognized in the macro body anywhere a label would be 
recognized (i.e., labels or opcodes). Parameters that 
are not labels are recognized anywhere (e.g., within 
labels, strings, or comments). 


Parameters are scanned left to right for a match, so 
the user is cautioned not to use parameter names that 
are prefix substrings of later parameter names. Formal 
parameters are not entered in the symbol] table. 


MACRGs can contain any statements including MACRO 
definitions and invocations, other assembler 
directives, and conditional assembly. The pseudo-ops 
«MACRO and .ENDM specify the beginning and end of a 
MACRO, respectively. 


The following special symbols are defined for use with 
MACROs. 


They can be reassigned using .SET pseudo-ops, and can 
be used as operands anywhere a label could be used. 


$'MACEVAL %' 


Used to replace an expression, used as a macro para- 
meter, with its value. 
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4.2.3 MACRO Invocation 
and Expansion 


4.2.4 MACRO Example 


4.3 PROC OR PROCEDURE 
MACRO 


4.3.1 PROC Definition 


$*MACQUOTE nye 


Used to include the following character in a macro 
parameter, despite any special meaning it may have. 


$ 'MACBEG fr 
$'MACEND rte 


Beginning and ending macro parameter delimiters. If 
different, they must be properly nested, or they could 
cause an escape with $'MACQUOTE. 


A MACRO is invoked when its name is used as_ the 
opcode. The rest of the line is made up of "actual 
parameters"--strings of characters separated by 
commas, possibly enclosed in quotes (normally 
{...}). Quoted parameters can include commas as well. 


The actual parameters on the invoking line replace the 
corresponding formal parameters from the defining line 
wherever they occur in the body of the macro. If 
legal, a formal parameter is replaced wherever it 
occurs as an identifier. If a formal parameter is not 
a legal identifier, it is matched as a string and is 
replaced wherever it occurs. The statement is 
assembled after these substitutions, and the resultant 


code placed in the program in place of the invoking 
statement. 


Assuming that the label UPDATE has already been 
defined, the .MACRO invocation 


START UPDATE 46,99,current 


substitutes the actual parameter strings 46, 99, and 
"current" for the first, second, and third formal 
parameters within the body of the MACRO named UPDATE. 


The procedure (or .PROC) macro is a call-by-value 
macro. The major difference between a .MACRO and a 
-PROC is that the parameters of the procedure-type 
macro are expressions that are evaluated before the 
~PROC is expanded. 


The general form of a PROC definition is: 
1] .PROC i1,...,1n  jstart PROC pseudo-op 


. (statements that form body of PROC) 


«ENDP 3;end PROC pseudo-op 





Macros 


4.3.1 PROC Definition 
(Cont inued ) 


4.5.2 PROC Invocation 
and Expansion 


4.3.3 PROC Example 


4.4 SPECIAL MACRO 
PSEUDO-OPS 


4.4.1 Exit Macro 


The required label is the name of the .PROC and is used 
to invoke it. The pseudo-ops .PROC and .ENDP specify 
the beginning and end of a PROC-type macro. The formal 
parameters are labels that are recognized only when 
they are used in expressions or as statement labels. 
PROCS can contain any statements including macro 
definitions and invocations, assembler commands, and 
conditional assembly. 


When a PROC is invoked, the expression parameters are 
evaluated and substituted into the body of the PROC as 
values. Then the PROC is assembled normally and its 
code is inserted into the program in place of the 
invocation statement. 


For example, assume the following PROC definition: 
ESTIMATE .PROC total,average 
(body of PROC) 
sENDP 
Using this invocation: 
ESTIMATE sum+12,sum+12/num 


would substitute the value of sum+12 for the formal 
parameter "total", and the value of sum+12/num for 
“average” in the ESTIMATE PROC. These values would 
then be used by the assembler in assembling the PROC in 
the program stream. 


Several special pseudo-ops are provided for use within 
MACROs. These pseudo-ops can stop macro expansions, 
define labels for each macro invocation, or provide 
looping capabilities. 


General Form: 

eEXITM n? 

Description: 

This pseudo-op stops the expansion of a macro. It can 
be used in all forms of a macro (MACRO or PROC) to 


force an early termination of the MACRO's expansion. 
The exit can be made on a conditional basis. 


4.4.2 Define Local 
Symbols 


4.4.3 Repeat 


4.4.4 Repeat On 
Parameter List 


Macros 


General Form: 
~LOCAL 11,...,1n 
Description: 


This pseudo-op defines local symbols within a macro. 
Each symbol given in the list with this pseudo-op is 
replaced in the expansion of the MACRO by the symbol 
",XXXX" where XXXX represents a hexadecimal number 
unique for each local symbol in each invocation of the 
macro. When used, the .LOCAL pseudo-op must 
immediately follow the defining MACRO or PROC 
statement. 


Example: 


POWER: .MACRO x 
~LOCAL two,three ;two and three will be assigned 
33a unique symbol for each 
;invocation of the macro. 


General Form: 


eREPT n 


~ENDM 
Description: 


The block of statements between .REPT and .ENDM is 
repeated n times. The value of nm must be absolute and 
not include forward references. 


Example: 


eREPT 4 


~-ENDM 


General Form: 


-IRP f,s 
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4.4.4 Repeat On 
Parameter List 
(Cont inued) 


4.4.5 Repeat On 
Character String 


4.5 SPECIAL MACRO 
OPERATORS 


4.5.1 °%* Operator 


Description: 


The quotes are stripped from the string, and the block 
of statements between .IRP and .ENDM is repeated, with 
each parameter in the string s replacing the formal 
parameter f in the expansion of the contained 
statement. 


Example: 


eIRP X, "4,8" sfirst 4, then 8, is substituted for 
seach occurrence of X from here to the 
send of the macro. 

~ENDM 


General Fora: 


-IRPC f,s 


«ENDM 
Description: 


The block of statements between .IRPC and .ENDM is 
repeated, with each character in s replacing the formal 
parameter f in the contained statements. 


Example: 


eERPC X, "1234567" 3sthe characters 1 
sthrough 7 are substituted 
sfor the seven iterations of this 
;macro. 


ENDM 


The following sections discuss operators and symbols 
that are useful mainly within macro definitions or 
invocations. These symbols are %, !, { }, ‘DEF, and 
ANUL. Note that the single-character operators can be 
redefined by changing the value of the corresponding 
special symbols. 


The symbol % in front of a label in a macro parameter 
causes the numeric value of the expression to be 
converted to a decimal ASCII string and incorporated 
into the parameter. The symbol % will be recognized 
within a symbol to construct new symbols. The label's 
value must be absolute, and may not contain a forward 
reference. 
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4.5.2 *!' Operator 


4.5.3 {...] 


4.5.4 ADEF 1 


4.5.5 ANUL 


The special symbol $MACEVAL can be used to change the 
character used for this function from its initial 
default of "%". | 


The character ! in front of a character in a macro 
parameter makes that character part of the parameter, 
even if the character is normally treated specially 
(e.g., , comma, etc.). The special symbol $MACQUOTE 
can be used to change the character used for this 
function from its initial default of "!". 


A macro parameter enclosed in braces will have an outer 
layer of braces eliminated. The beginning and ending 
braces ere the value of $'MACBEG and $'MACEND, 
respectively, but can be changed. 


Beginning and ending braces must be properly nested. 
If the beginning and ending characters are the same, 
they cannot be nested. However, the character itself 
may be entered by either doubling it (e.g., "™) or 
preceding it with ‘!'. 


ADEF followed by a symbol expands to a non-zero value 
if the symbol has been defined (previous to the current 
line) or O if the symbol has not been defined. 


ANUL expands to a non-zero value if it is the last 
token on a line (not counting 3 comment), or 0 
otherwise. The rest of the line is ignored. 
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>.1 ASSEMBLER COMMAND 
LINES AND OPTIONS 


Option 


-d 

-en 

-] 

-o objfile 
~ob 


-p 
-r 
-s symfile 


-U 
-W 
—X 


CHAPTER 5 
PROGRAM INVOCATION 


The asmS8 assembler accepts various command line 
options for assembly, creates a listing, and creates 
an object file in a universal file format suitable for 
use by such utilities as a loader (see the Universal 
Object File Utilities User's Guide). 


The assembler is invoked as follows: 
asmS8 [option . . .] file 


Valid assembler options are listed in Table 5-1. 


Table 5-1. Assembler Options 
Meaning 


Reserved 

Stop after n errors 

Produce listing for files in file.1 

Specify object file name other than a.out 

Produce object in binary form 

Produce object in character form 

Produce object with file and line number in 
comment level 1 

Produce object with source lines in comment 
level 2 

Produce object with user-generated warnings 
in comment level 2 

Produce listing on standard output 

Restrict to Z8 instruction set 

Get assembler's symbol table initialization 
from symfile 

Treat undefined symbols as externals 

Don't list warnings 

Produce cross-reference on file.x 


If the -1 option is given and the source filename ends 
in ".s", the listing is produced in filename.1. If the 
-s flag is not used, the assembler will obtain its 
symbols from a file on /z/bin/asm* whose name was 
used to invoke the assembler. Normally, this is 
/z/bin/lib/asm/asmS8**, The symbol file is an 
ordinary ASCII source file, and can contain = any 
constructs that do not generate object code. This is 
used to create custom versions of the assembler. 


* for VAX/UNIX it is /usr/local/bin/asm 
** for VAX/UNIX it is :/usr/local/bin/asm/asmS8 
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522 LISTING FORMAT 


5.35 PROGRAM 
TERMINATION 


The assembler produces a listing of the source program, 
along with generated object code. The various fields 
in the listing format are the heading, the location 
counter (LOC), the object code (083 CODE), the state- 
ment number (LINE#), and the source’ statement 
(SOURCE). They contain the following: 


e The heading is on the first page of the listing and 
contains the date, time, year, file name, and page 
number, aS well as the column headings LOC, OBJ 
CODE, LINE#, and SOURCE. 


@e LOC contains the value of the location counter for 
statements. 


e OBJ CODE contains the qenerated object code. If 
a statement does not generate object code, this 
field is blank. Relocatable values are represented 
as Rsss+nnnnnnnn where ssss is the section number 
and nnnnnnnn is the offset within the section. 
Externals are noted by the letter x, with a capital 
X representing the first byte. An asterisk (*) 
notes other link-time expressions that are not 
Simply relocatable. 


@ LINE# contains the sequence number of each line of 
the source, starting at 1. 


@e SOURCE contains the source code including labels, 
opcodes, operands, and comments. 


Appendix — shows a sample listing. 


The assembler returns an error code of 0 if the program 
has no errors. Otherwise, the assembler returns an 
error code of 1 and error messages will appear im the 
listing. These error messages will also be sent to the 
terminal with the relevant file and line numbers. If 
possible, an object file will be created even if errors 
are present. Appendix D lists the error messages and 
their explanations. 
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APPENDIX A 
PSEUDO-OP SUMMARY 


The following abbreviations apply to the pseudo-op 





summary : 
n Numeric expression 
s String 
sn String or numeric expression 
d Decimal digit 
p Actual parameter 
f Formal parameter 
1 Label (optional, more than one allowed) 
11 Label (required, only one allowed) 
coe May be repeated 
? Optional 
[...] Not exactly equivalent (either form acceptable) 
Label Pseudo-Op Operand Meaning 
Relocation Operations We 
] ~ORG n Origin 
« PHASE n Phase 
.DEPHASE Dephase 


Section Operations 


e-MODULE p p? Module name 
] ~SECTION Me gigs Define 2 section 





Label Definition Operations 


li EQU n Equate 

ll oSET n Define a label 
- GLOBAL i] ses Global symbols 
EXTERNAL LI cee External symbols 





Data Definition Operations 


1 -DD SN 20. Define data 

] BYTE NM see Define byte data 

l - WORD ae Define word data 

st . LONG n Define lonqword data 

] - QUAD fees Define quadword data 

] ~ QUINT Hite Define 5-byte (extended) data 

} EXTEND MN ees Define extended data 

1 ASCII SN ..- Define ASCII string 

j eASCIL S sss Define ASCII string with length 
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Label Pseudo-Op 


Operand 


Meaning 


Data Definition Operations — (Continued) 


1 eASCIC 


] eASCIZ 


Ss ee 9 


s eee 


Reserve Space Operations 


Define ASCII string with 
flagged last character 

Define null-terminated 
ASCII string 





1 «BLOCK nn? Reserve a block with optional 
alignment 
1 »BLKB n Reserve a block of bytes 
] -BLKW n Reserve a block of words 
1 ~BLKL n Reserve a block of longwords 
1 -BLKQ n Reserve a block of quadwords 
] ~BLKX n Reserve a block of extended data 
Conditional Assembly 
olF n Start conditional block 
~ELSE n False branch of conditional 
ENDIF n End conditional block 


Assembler Control Operations 


«END 

- INCLUDE 
TITLE 

- SUBTTL 
eLIST 
eWLIST 
eMLIST 
oXLIST 
ERROR 

. WARN 

« PAGE 
LIBRARY 
-OCOMMENT 


Macro Operations 


1] -MACRO 


1] « PROC 
-ENDP 


EXITM 
~ LOCAL 
eREPT 
- RP 
- [RPC 
eENDM 


? 


=] 


onvD UD VV UV 


30 35 
~ ~~) 
— 

f 


End program 


Include 
Listing 


Subtitle 


Control 
Control 
Control 
Control 
List an 


a source file 
title 


listing 

conditional listing 
macro listing 

macro object listing 
error message 


List a warning message 


Start a 
Library 


new page 
search 


Object comment 


Define macro. 
End MACRO definition 


Define a procedure 
End PROC definition 


End macro expansion 
Define macro labels 


Repeat. 


Repeat on parameter list 
Repeat on character string 
End repeated block 
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APPENDIX B 
SPECIAL SYMBOLS 


The following special symbols are defined. They can be 
reassigned using .SET pseudo-ops, and can be used as 
operands anywhere a label could be used. If needed, 
additional special symbols will be defined later. 





Symbol 


$'LIST 

$'WLIST 
$'CLIST 
$'MLIST 
$'XLIST 


Initial 
Value Meaning 
1 Controls the whole listing 
1 Controls the warning listing 
1 Controls listing of false conditional 
1 Controls macro expansion listing 
1 Controls listing of object code that does 


not fit on original source line 


These special symbols are used for control of the 
listing. If the low-order bit is 1, the corresponding 
item is listed. If the low-order bit is 0, the item is 
not listed. 


$'LIST controls the listing as a whole, $'WLIST 
controls the listing of warning messages, $'CLIST the 
listing of false conditionals, $'MLIST the listing of 


macro expansions, and $'XLIST the listing of object 
code that does not fit on the original source line. 


Default 
Value 
$'SYMLEN 127 
The maximum number of significant characters in a 
symbol. 
$ "UCASE 0 


Treat all letters as uppercase. 


$'STRESC \s 


The string-escape character. The meaning of the 
following character is given in the table in section 
3.3.2 (constants). 
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$'SILEN 10 
$'S1ORD "M! 
$'S2LEN 10 
$'S20RD "! 


The length and byte-order ('M' = most significant 
byte first, 'L’' = least significant byte first) of 
strings surrounded by single and double quotes 
respectively. In the byte-order parameters, only 
the least-significant bit is actually looked at. Thus, 
0 and 71 can be used instead of ‘L' and 'M', 
respectively. 


$'SxLEN and $'SxORD are provided because previous 
Z8000 assemblers have evaluated byte order differently 
when using strings as numbers. 


$' BASE 10 
$'ZBASE 10 
$'SBASE 8 


The input default number bese for numbers that start 
with non-zero digits, numbers that start with zero, and 
string escape sequences respectively. Setting $'ZBASE 
to 8 gives the C convention for octal numbers. Terms 
like $'BASE must be in the range 2 to 16. 

$"ADRLEN 2 

The length in bytes of an address. The value for 
$"ADRLEN is 2. 

$'ADRORD '™' 

The byte-order of an address. $'ADRORD is normally 
left as 'M'; this can be changed if the assembler is 
being used to produce non-Z80,000 code. 

$*ADRTYPE 0 

This indicates the current addressing type: 0 = 
linear, 1 = seqmented, 2 = compact (nonseqmented). 


$*ALIGN 1 


The alignment boundary for instructions and data with 
length >= 1 byte. 
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$'EPUID 0 


The current EPU Identifier. Unused. 


$'Z8 O (1 if -r option) 


When set to 1, the Super8 instruction set is accepted. 
When cleared to O (explicitly or with an option), the 
Z8 instruction set is accepted. 


$'OPCOPT 0 


If the value is not zero and an opcode is missing on a 
line containing expressions, the opcode .DD (arbitrary- 
length data) will be assumed. 
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ASCII CHARACTER SET 


Graphic 


+ KEN ~ RO AH 


. 





Numeric 
Decieasl Hex 
0 0 
1 1 
2 2 
3 3 
4 4 
5 5 
6 6 
7 7 
8 8 
9 9 
10 A 
11 B 
12 C 
13 D 
14 E 
15 F 
16 10 
17 11 
18 12 
19 13 
20 14 
21 15 
22 16 
23 17 
24 18 
25 19 
26 1A 
27 1B 
28 1¢ 
29 1D 
30 1E 
31 1F 
32 20 
33 21 
34 22 
35 23 
36 24 
37 25 
38 26 
39 27 
40 28 
41 29 
42 2A 
43 2B 
44 2C 
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Comments 


Null 

Start of heading 
Start of text 

End of text 

End of transmission 
Enquiry 
Acknowledge 

Bell 

Backspace 
Horizontal tabulation 
Line feed 

Vertical tabulation 
Form feed 

Carriage return 
Shift out 

Shift in 

Data link escape 
Device control 1 
Device control 2 
Device control 3 
Device control 4 
Negative acknowledge 
Synchronous idle 
End of block 
Cancel 

End of medium 
Substitute 

Escape 

File separator 
Group separator 
Record separator 
Unit separator 
Space : 
Exclamation point 
Quotation mark 
Number sign 

Dollar sign 
Percent sign 
Ampersand 

Apost rophe 

Opening parenthesis 
Closing parenthesis 
Asterisk 

Plus 

Comma 
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ASCII Character 


Set Numeric 

(Continued ) Graphic Decimal Hex Comments 
- 45 20 Hyphen (minus) 
; 46 2E Period (decimal point) 
/ 47 2F Slant 
0 48 30 Zero 
1 49 31 One 
2 50 32 Two 
3 51 33 Three 
4 52 34 Four 
5 53 35 Five 
6 54 36 Six 
7 55 37 Seven 
8 56 38 Eight 
9 57 39 Nine 
: 58 3A Colon 
: 59 3B Semicolon 
< 60 3C Less than 
= 61 3D Equals 
> 62 3E Greater than 
? 63 SF Question mark 
8 64 40 Commercial at 
A 65 41 Uppercase A 
B 66 42 Uppercase B 
C 67 43 Uppercase C 
D 68 44 Uppercase D 
E 69 45 Uppercase E 
F 70 46 Uppercase F 
G 71 47 Uppercase G 
H 72 48 Uppercase H 
I 73 49 Uppercase I 
J 74 4A Uppercase J 
K 75 4B Uppercase K 
L 16 4C Uppercase L 
M 77 4D Uppercase M 
N 78 4E Uppercase N 
0 19 4F Uppercase 0 
P 80 50 Uppercase P 
Q 81 51 Uppercase Q 
R 82 52 Uppercase R 
S 83 53 Uppercase S 
T 84 54 Uppercase T 
U 85 55 Uppercase U 
V 86 56 Uppercase V 
W 87 57 Uppercase W 
X 88 58 Uppercase X 
Y 89 39 Uppercase Y 
Z 90 5A Uppercase Z 
f 91 5B Opening bracket 
\ 92 5C Reverse slant 
| 93 50 Closing bracket 
A 94 5E Circumflex 
— 95 oF Underscore 

96 60 Grave accent 
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Set 
(Cont inued) 


Graphic 
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Numeric 
Decimal Hex 
97 61 
98 62 
99 63 
100 64 
101 65 
102 66 
103 67 
104 68 
105 69 
106 6A 
107 6B 
108 6C 
109 6D 
110 6E 
111 6F 
112 70 
113 71 
114 72 
115 73 
116 74 
117 75 
118 76 
119 77 
120 78 
121 79 
122 7A 
123 7B 
124 7¢ 
125 7D 
126 7E 
127 TF 


Comments 


Lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
Lowercase 
lowercase 
Lowercase 
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Opening (left) brace 
Vertical line 
Closing (right) brace 


Tilde 
Delete 
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APPENDIX D 
ERROR MESSAGES AND EXPLANATIONS 


ENDIF (end conditional) expected 

-IF was seen but not followed by 2 matching .ENDIF. 
ENDM (end macro definition) expected 

End of file was reached while still inside a macro definition. 
can't set read-only symbol 


An attempt was made to set a special symbol such as $'PASS, that cannot be 
redefined. 


extended instruction set not 3llowed 
An attempt was made to use a Super8 instruction or addressing mode not 
available on the Z8 CPU while the -r option or $' Z8 flag is in 
effect. 


extra parameters (ignored) 


A pseudo-op was passed more parameters than it requires. The extra 
parameters will be ignored. 


extra right parenthesis (ignored) 


A right parenthesis was seen without a matching left parenthesis. It is 
ignored. 


forward reference not allowed here 


An expression in an IF, COND, EQU, or SET contains a forward reference 
(a label that has not been defined earlier in the program). 


label required 
A pseudo-op such as EQU or SET, which require a label, does not have one. 
line too long (truncated) 


The source file or a macro expansion contains a line longer than 512 
characters. 


link-time expression not allowed here 


An expression that cannot be evaluated by the assembler has been used in a 
context where the assembler needs to know its value. 
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missing parameter 
A pseudo-op has been given fewer parameters than it requires. 
missing right parenthesis (assumed) 
The end of an expression was encountered without finding a right 
parenthesis to match a left parenthesis already seen. The assembler 
will evaluate the expression as if the missing parenthesis had been at 
the end of the expression. 


Multiple definition 


A symbol has been used as a label, defined by an EQU, or defined as a 
macro more than once. 


no input file 
The assembler cannot open the specified input file. 
operand expected (0 assumed) 


A binary expression operator (such as +) was not followed by an operand. 
A zero operand is assumed. 


operation not defined on register 
An expression operator (such as *) has been applied to a register value for 
which it is not valid. The only expression operators that can be applied 
to registers are indexing and indirection. 

parser stack overflow 
The assembler received an expression too complex for it to handle. 


phase error-——-passes out of sync. 


Something happened differently on passes 1 and 2 of the assembler. This 
can occur if an opcode or pseudo-op is used and later redefined as a macro. 


storage allocation failed 


The assembler ran out of storage as a result of a combination of symbol 
table, macro definitions, and macro invocations. 


syntax error 


A source statement contains a syntactic error, usually in an expression, 
which cannot be otherwise classified. 
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undefined addressing mode expression 


An expression represents an addressing mode not available on the Super8 and 
Z8 CPU, such as (HL + A). 


undefined character 
A character appears in the input that the assembler does not understand. 
undefined symbol 


A symbol has been used that is never defined. The value O will normally 
be used. 


value out of range 


An expression does not fit in the specified size of field (for example, 
an address in a .BYTE statement). 


wrong operand type for this operation 


An opcode has been given an operand with an addressing mode that does not 
apply to it. 
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asnS8 version 1.0 


LOC 
00000000 
00000002 
00000004 
00000007 
- 0000000a 

0000000d 
00000010 
00000013 
00000016 
00000019 
0000001c 
0000001F 


00000022 
00000024 
00000026 
00000029 
0000002c 
0000002£ 
00000032 
00000035 
00000038 
0000003 b 
0000003e 
00000041 


00000044 
00000046 
00000048 
0000004b 
0000004e 
00000051 
00000054 
00000057 
0000005a 
0000005d 
00000060 
00000063 


00000066 
00000068 
0000006a 


0000006d 


0000006e 
00000070 
00000072 
00000074 


00000076 
00000078 


OBJ 

1235 

1335 

1440e3 
14e520 
144020 
1540e3 
15e520 
154020 
16e340 
162040 
172040 
17 e340 


0235 

0335 

044063 
04e520 
044020 
0540e3 
05e520 
054020 
06 e340 
062040 
072040 
07 e340 


5235 

5335 

5440e3 
54e520 
544020 
554063 
55e520 
554020 
56e340 
562040 
572040 
57 e340 


d4e2 
d420 
d60040 


ef 


bd e3 
b020 
ble3 
b120 


6063 
6020 


t.z8inst 
LINE# ---- SOURCE --- 
l adc 
2 adc 
3 adc 
4 adc 
5 adc 
6 adc 
7 adc 
8 adc 
9 ade 
10 ade 
ll adc 
12 adc 
13 
14 add 
15 add 
16 add 
17 add 
18 add 
19 add 
20 add 
21 add 
22 add 
23 add 
24 add 
25 add 
26 
27 and 
28 and 
29 and 
30 and 
3) and 
32 and 
33 and 
34 and 
35 and 
36 and 
37 and 
38 and 
39 
40 call 
4l call 
42 call 
43 
44 ecf 
45 
46 clr 
47 clr 
48 clr 
49 clr 
50 
51 com 
52 con 
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r3,r5 
r3,@r5 
r3 ,64 
32,r5 
32 ,64 
r3 ,@64 
32 ,@r5 
32 ,@64 
r3 , #64 
32 , #64 
@32 , #64 
@r3 ,#64 


r3,r5 
r3,@r5 
r3,64 
32,,%5 
32,64 
r3 ,@64 
32 ,@r5 
32 ,@64 
r3,#64 
32, #64 
@32, #64 
@r3, #64 


r3,r5 
r3,@r5 
r3,64 
32 ,r5 
32,64 
r3 ,@64 
32,@r5 
32 ,@64 
r3,#64 
32, #64 
@32,#64 
@r3 , #64 


@rr2 
@32 
64 


r3 
32 
@r3 
@32 


r3 
32 
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0000007a 6123 53 con @r3 
0000007c 6120 54 com @32 

55 
0000007e a235 56 cp r3,r5 
00000080 a335 57 cp r3,@r5 
00000082 a440e3 58 cp r3,64 
00000085 a4e520 59 cp 32,4r5 
00000088 a44020 60 cp 32,64 
0000008b a540e3 61 cp 13 ,@64 
0000008e a5e520 62 cp 32 ,@r5 
00000091 a54020 63 cp 32 ,@64 
00000094 a62340 64 cp 13, #64 
00000097 a72040 65 cp @32, #64 
0000009a a7e340 66 cp @r3 , #64 

67 
0000009d 40e3 68 da r3 
O000009£F 4020 69 da 32 
000000al 41e3 70 da @r3 
000000a3 4120 71 da @32 

72 
000000a5 00e3 73 dec r3 
000000a7 0020 74 dec 32 
00000049 01e3 75 dec @r3 
000000ab 0120 76 dec @32 

77 
000000ad 80e2 78 decw rr2 
o000000af 8020 79 decw 32 
000000bl1 81e3 80 decw @r3 
000000b3 8120 81 decw @32 

82 
O000000b5 8F 83 di 

84 
000000b6 3afe 85 d jnz r3,$ 

86 
OOQVOO0Ob8 IF 87 ei 

88 
000000b9 3e 89 ine r3 
000000ba 2020 90 inc 32 
000000be 21e3 91 inc @r3 
000000be 2120 92 inc @32 

93 
000000c0 ade2 94 incw rr2 
000000c2 a020 95 incw 32 
000000c4 ale3 96 inew @r3 
000000c6 al20 97 incw @32 

93 
000000c8 bf 99 iret 

100 
000000c9 8d0400 101 jp 1024 
000000cc ed0400 102 jp nz,1024 
000000cE 30¢e2 103 jp @rr2 
00000041 3020 104 ip @32 

105 
000000d3 8bfe 106 jr $ 
000000d5 ebfe 107 jr nz,$ 
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SE ELT ISIE STN I I A TI TE ET EE ET TO I IEE EAE ODE APES S ST TIE ST NE TOT TE SEDI I DEE STO EEE EIT TEES ADELE PE IDES I NTT ICT ICSI EOE TE EE A ETT III LIE LTE IEEE TES EE I IEEE 


000000d7 


00000049 
000000db 
000000dd 


oooo0oddr 
000000e1 


000000e3 


000000 6 
000000e8 
000000eb 
000000ee 


000000f1 
000000£3 
000000£6 
000000£9 


000000fc 
000000fe 
00000101 
00000104 


00000107 
0000010a 


0000010d 
0000010f 


00000111 
00000113 


00000115 
00000117 


00000119 
0000011b 


0000011d 


000001le 
00000120 
00000122 
00000125 
00000128 
0000012b 
000001 2e 
00000131 
00000134 
00000137 
000001 3a 


3c40 


38e5 
3840 
5920 


e335 
£335 


e44020 


e335 

e540e3 
e5e520 
e54020 


3c40 

e62040 
e7 e340 
d62040 


£335 

£540e3 
£5e520 
£54020 


73540 
d75340 


c234 
d252 


c334 
d352 


8234 
9252 


9352 
8334 


ff 


4235 

4335 

4440063 
44e520 
444020 
4540e3 
45e520 
454020 
46e340 
462040 
472040 


108 
109 
110 
LLL 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 


152: 


153 
154 
155 
156 
157 
158 
159 


160 


161 
162 


ld 


Iq 
1d 
1d 


1d 
1d 


ld 


lde 
ldc 


ldci 
ldci 


lde 
lde 


ldei 
ldei 


nop 


or 
or 
or 
or 
or 
or 
or 
or 
or 
or 
or 
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r3,#64 


r3,r5 
r3 ,64 
32 ,3r5 


r3 ,@r5 
@r3 ,r5 


32,64 


r3 ,@r5 
r3 ,@64 
32,@r5 
32 ,@64 


r3 , #64 
32 , #64 
@r3, #64 
@32, #64 


@r3,r5 
@r3 64 
@32 .r5 


@32,64 


r3,64(r5) 
64(r3),r5 


r3,@rr4 
@rr2 ,r5 


@r3 ,@rr4 
@rr2 ,@r5 


r3,@rr4 
@rr2,r5 


@rr2 ,@r5 
@r3 ,@rr4 


t3,75 
r3,@r5 
r3,64 
32,73 
32,64 
r3 ,@64 
32,@r5 
32 ,@64 
r3, #64 
32,464 
@32, #64 
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E 


cme gti 0 tt tt PED SS ES 


0000013d 


00000140 
00000142 
00000144 
00000146 


00000148 
0000014a 
0000014c 
000001L4e 


00000150 
OCOOOLSL 


00000152 
00000154 
00000156 
00000158 


0000015a 
0000015c 
000001L5e 
00000160 


00000162 
00000164 
00000166 
00000168 


0000016a 
0000016c 
0000016e 
00000170 


00000172 
00000174 
00000176 
00000179 
0000017c 
0000017f 
00000182 
00000185 
00000188 
0000018b 
0000018e 
00000191 


00000194 


00000195 
00000197 
00000199 
0000019b 


472340 


5023 
5020 
51e3 
5120 


7063 
7020 
71e3 
7120 


cf 
af 


90e3 
9020 
91e3 
9120 


10e3 
1020 
11¢3 
1120 


e0e3 
e020 
ele3 
e120 


c0e3 
c020 
cle3 
e120 


3235 

3335 

344063 
34e520 
344020 
3540e3 
35e520 
354020 
36e340 
362040 
372040 
37e340 


df 


d0e3 
d020 
dle3 
d120 


163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 


190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 


or 


pop 
Pop 
pop 
pop 


push 
push 
push 
push 


ref 
ret 


rl 
tl 
rl 
rl 


rle 
rle 
rle 
rle 


rr 
rr 
rr 
Tr 


rre 
tre 
rre 
rre 


sbec 
sbc 
sbe 
sbc 
sbc 
sbe 
sbe 
sbc 
sbe 
sbc 
sbe 
sbc 


scf 


sra 
sta 
sTa 
sta 


@r3, #64 


r3 
32 
@r3 
@32 


r3 
32 
@r3 
@32 


r3 
32 
@r3 
@32 


r3 
32 
@r3 
@32 


r3 
32 
@r3 
@32 


r3 
32 
@r3 
@32 


r3,r5 
r3 ,@r5 
r3 ,64 
32,r5 
32,64 
r3 , @64 
32 ,@r5 
32 ,@64 
r3,#64 
32 , #64 
@32 , #64 
@r3 , #64 


r3 
32 
@r3 
@32 
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0000019d 


0000019 
000001al 
000001a3 
00000146 
00000149 
000001ac 
000001a£ 
000001 b2 
00000165 
000001 b8 
000001 bb 
000001 be 


000001 cl 
0000013 
000001c5 
000001 c7 


0000019 
000001eb 
000001cd 
00000140 
000001 43 
00000146 
00000149 
000001dc 
O00001dE 
000001e2 
000001e5 
000001e8 


00000 1leb 
000001led 


00000 lef 
000001£f2 
000001 £5 
000001F8 


000001 fb: 


000001 fe 
00000201 
00000204 
00000207 
0000020a 


0000020d 
O0000020£ 
00000211 
00000214 
000060217 
0000021a 
0000021d 


3170 


2235 

2335 

2440083 
24e520 
244020 
2540283 
25e520 
254020 
26e340 
262040 
272040 
272340 


£0e3 
£020 
fle3 
£120 


6235 

6335 

6440e3 
64e520 
644020 
6540e3 
65e520 
654020 
66e340 
662040 
672040 
67e340 


7235 
7335 


744063 
74e520 
744020 
7540e3 
75e520 


754020 


762340 
762040 
772040 
772340 


b235 

b335 

b440e3 
b4 e520 
b44020 
b540e3 
b5e520 


218 
219 
220 
22% 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 


257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
2638 
269 
270 
271 
272 


srp 


sub 
sub 
sub 
sub 
sub 
sub 
sub 
sub 
sub 
sub 
sub 
sub 


swap 
swap 
swap 
swap 


tcm 
tcm 
tcm 
tcm 
tem 
tem 
tcm 
tcm 
tem 
tem 
tcm 
tcm 


tm 
tm 


tn 
tm 
tu 
tm 
tn 
tm 
tm 
tm 
tm 
tm 


XOr 
xOor 
xor 
xor 
xor 
xor 
xor 
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#70h 


r3,r5 
3 ,@r5 
r3,64 
32,45 
32,64 
r3,@64 
32 ,@r5 
32 ,@64 
r3,#64 
32, #64 
@32,#64 
@r3 , #64 


r3 
32 
@r3 
@32 


r3,r5 
r3 ,@r5 
r3,64 
32 ,4r5 
32,64 
r3 ,@64 
32 ,@r5 
32 ,@64 
r3,#64 
32, #64 
@32 ,#64 
@r3 , #64 


r3,xr5 
r3 ,@r5 


r3,64 
32,r5 
32,64 
r3 ,@64 
32 ,@r5 
32,064 
63, #64 
32, #64 
@32, #64 
@r3 , #64 


r3,r5 
r3,@r5 
r3,64 
3237) 
32 ,64 
r3,@64 
32 ,@r5 
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00000220 b54020 
00000223 »b6e340 
00000226 b62040 
00000229 b72040 
0000022c b7e340 


0000022£ 38ff 
00000231 38fe 
00000233 38fd 
00000235 38£fc 
00000237 38£b 
00000239 38fa 
0000023b 38£9 
0000023d 38£8 
0000023£ 38£7 
00000241 38£6 
00000243 38£5 
00000245 38£4 
00000247 38£3 
00000249 38£2 
0000024b 38f1 
0000024d 38£0 
0000024f 3803 
00000251 3802 
00000253 3801 
00000255 3800 


00000257 38ff 
00000259 38fe 
0000025b 38fd 
0000025d 38fc 
0000025f 38fb 
00000261 38fa 
00000263 38£9 
00000265 38£8 
00000267 38f7 
00000269 38f6 
0000026b 38£5 
0000026d 38£4 
0000026£ 38£3 
00000271 38f2 
00000273 38f1 
00000275 38f0 
00000277 3803 
00000279 3802 
0000027b 3801 
0000027d 3800 


273 xor 32 ,@64 
274 xor r3,#64 
275 xor 32, #64 
276 xor @32, #64 
277 xor G@r3, #64 
278 

279 

280 ;defined register names 
281 

282 id r3,spl 
283 1d r3,sph 
284 1d r3,rp 
285 ld r3,flags 
286 1d r3,imr 
287 1d r3,irgq 
288 1d r3,ipr 
289 1d r3,p01lm 
290 1d r3,p3m 
291 ld r3,p2m 
292 1d r3, pred: 
293 ld | r3,t0 
294 1d r3,prel 
295 ld r3,tl 
296 1d r3,tmr 
297 ld r3,sio 
298 1d r3,p3 
299 1d. r3,p2 
300 1d r3,pl 
301 ld r3,p0 
302 

303 

304 ;defined register names 
305 

306 1d r3,SPL 
307 1d r3,SPH 
308 ld r3,RP 
309 1d r3,FLAGS 
310 ld r3, IMR 
311 1d r3, IRQ 
312 1d r3, IPR 
313 1d 13, POLM 
314 1d r3,P3M 
315 1d r3,P2M 
316 1d 13, PREO 
317 1d r3,TO 
318 1d r3,PREL 
319 1d r3,Tl 
320 1d r3,TMR 
321 ld r3, SIO 
322 1d r3,P3 
323 1d r3,P2 
324 1d r3,P1 
325 1d r3,P0 
326 


327 ;test for cundition codes 
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0000027¢f 


00000282 
00000285 
00000288 
0000028b 


0000028e 
00000291 


00000294 
00000297 
0000029a 
0000029¢4 


000002a0 
000002a3 


000002a6 
000002a9 


000002ac 
000002 af 
000002 b2 
000002 b5 


0d0080 


6d0080 
ed0080 
6d0080 
ed0080 


7d0080 
£d0080 


ad0080 
1a0080 
9d0080 
2 d0080 


dd0080 
5d0080 


cd0080 
4d0080 


bd0080 
7d0080 
£d0080 
3d0080 


jp 
jp 
ip 
jp 
jp 


jp 
jp 


ip 
3p 


ip 


jp 
ip 


ip 
ip 


jp 
jp 


jp 
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f 128 


z,128 

nz,128 
eq ,128 
ne ,128 


c,128 
ne ,128 


gt,128 
1t ,128 
ge ,128 
le ,128 


p1,128 
mi,128 


nov ,128 
ov,128 


ugt ,128 
ult ,128 
uge ,128 
ule,128 
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asmS8 version 1.0 


E-8 


t.s8inst 
LOC OBJ LINE# --- SOURCE --- 
1 ;reference test source for Super8 instructin set. 
2 
3 
00000000 1235 4 ade r3,7r5 
00000002 1335 5 ade r3 ,@r5 
00000004 1440c3 6 adc 63,04 
00000007 14¢520 7 adc 32,r5 
0000000a 144020 8 adc 32,64 
0000000d 15403 9 ade r3 ,@64 
00000010 15¢520 10 ade 32 ,@r5 
00000013 154020 11 ade 32 ,@64 
00000016 16c340 12 adc r3, #64 
00000019 162040 13 adc 32, #64 
14 
0000001le 0235 15 add r3,r5 
000000le 0335 16 add r3,@r5 
00000020 0440c3 17 add 13,64 
00000023 04c520 18 add 32 ,4r5 
00000026 044020 19 add 32,64 
00000029 0540c3 20 add r3 ,@64 
0000002¢ 05c520 21 add 32 ,@r5 
0000002f 054020 22 add 32 ,@64 
00000032 06c340 23 add 13, #64 
00000035 062040 24 add 32, #64 
25 
00000038 5235 26 and r3,r5 
0000003a 5335 27 and r3,@r5 
0000003¢ 5440c3 28 and r3,64 
0000003£ 54c520 29 and 32,xr5 
00000042 544020 30 and 32,64 
00000045 5540c3 31 and r3 ,@64 
00000048 55520 32 and 32,@r5 
0000004b 554020 33 and 32 ,@64 
0000004e 56c340 34 and 13, #64 
00000051 562040 35 and 32, #64 
36 
00000054 673ec5 37 band = r3,r5,#7 
00000057 673e40 38 band 13,64,#7 
0000005a 675fc3 39 band 1r3,#7,r5 
0000005d 675£20 40 band 32,#7,r5 
AL 
00000060 173ec5 42 bep r3,r5,#7 
00000063 173e40 43 bep 13,64,#7 
44 
00000066 573e 45 bite 13,#7 
46 
00000068 773e 47 bitr 1r3,#7 
48 
0000006a 773£ 49 bits r3,#7 
50 
0000006c 073ec5 SL bor r3,75,#7 
O000006F 073640 52 bor r3 64, #7 
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00000072 
00000075 


00000078 
0000007b 


0000007e 
00000081 
00000084 
00000087 


0000008a 
0000008c 
-0000008e 
00000090 


00000093 


00000094 
00000096 
00000098 
0000009 a 


0000009c 
0000009e 
000000 a0 
000000a2 


000000a4 
000000 a6 
000000 a8 
000000ab 
000000ae 
000000bl 
000000b4 
000000b7 
000000ba 


000000bd 
000000c0 


000000 c3 
000000c5 
000000c7 
000000c9 


000000cb 
000000cd 
000000cf 
000000d1 


00000043 
000000d5 
000000d7 


075fc3 
075£20 


375efd 
375ffd 


273ec5 
273e40 
275£c3 
275£20 


d420 
£4c2 
£420 
£60040 


ef 


b0c3 
b020 
bl ¢c3 
b120 


60c3 
6020 
61c3 
6120 


a235 

a335 

2440c3 
a4c520 
a44020 
2540c3 
a5c520 
a54020 
a6¢c340 


d253fd 


c253f£d 


403 


4020 
413 
4120 


00c3 
0020 
01¢3 
0120 


80c2 
8020 
81c3 


bor 
bor 


bt jrf 
btjrt 


bxor 
bxor 
bxor 
bxor 


call 
call 
call 
call 


ecf 


clr 
clr 
clr 
clr 


com 
com 
com 
com 


cp 
cp 
cp 
cp 
cp 
cp 
cp 
cp 
cp 


cpi jne 
cpije 


da 
da 
da 
da 


dec 
dec 
dec 
dec 


decw 
decw 
decw 


r3,#7,r5 
32,#7,4r5 


$,r5,#7 
$,r5,#7 


r3,r5,#7 
r3 ,64, #7 
r3,#7,r5 
32 ,#7,r5 


#32 
@rr2 
@32 
64 


r3 
32 
@r3 
@32 


r3 
32 
@r3 
@32 


r3,r5 
r3 ,@r5 
63,64 
32 ,r5 
32 ,64 
r3 ,@64 
32 ,@r5 
32 ,@64 
r3,#64 


r3,@r5,$ 
r3,@r5,$ 


r3 
32 
@r3 
@32 


r3 
32 
@r3 
@32 


rr2 
32 
@r3 
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000000d9 8120 108 decw @32 
109 
O000000db 8f 110 di 
lll 
000000dc 94c5c2 112 div rr2,r5 
O0OO0O0OO0d£ 9440c2 113 div rr2 ,64 
000000e2 94c520 114 div 32 ,r5 
000000e5 944020 115 div 32,64 
000000e8 95c5c2 116 div rr2 ,@r5 
000000eb 9540c2 117 div rr2 ,@64 
000000ee 95520 118 div 32 ,@r5 
000000f1 954020 119 div 32 , C64 
000000£4 9640c2 120 div rr2,#64 
000000f7 964020 121 div 32 , #64 
122 
000000fa 3afe 123 djnz  13,$ 
124 
Q00000fe IF 125 ei 
126 
OOOO00O0fd 1f 127 enter 
128 
O00000fe 2£ 129 exit 
130 
OOOOOOFFE 3e. 131 inc x3 
00000100 2020 132 inc 32 
00000102 21¢3 133 inc @r3 
00000104 2120 134 inc @32 
135 
00000106 a0c2 136 inecw rr2 
00000108 ' a020 137 inew 32 
0000010a alc3 138 inew @r3 
0000010c al20 139 incw @32 
140 
0000010e bf 141 iret 
142 
0000010f 8d0400 143 jp 1024 
00000112 ed0400 144 3p nz,1024 
00000115 30c2 145 jp @rr2 
00000117 3020 146 jp @32 
147 
00000119 8bfe 148 jr $ 
QOOOO0OL1b ebfe 149 jr nz,$ 
150 
Q0000011d 3c40 151 1d r3,#64 
152 | 
0000011£ 38c¢5 153 ld 13,r5 
00000121 3840 154 ld r3,64 
00000123 5920 155 ld 32,xr5 
156 
00000125 ¢735 157 1d r3,@r5 
00000127 4735 158 1d @r3 5 
159 
00000129 e44020 160 ld 32,64 
161 
0000012c ¢735 162 1d r3,@r5 


Appendix £ 


RN eae eases shes pn iienesinasnanaapnanentne 


0000012e 


00000131 
00000134 


00000137 
00000139 
0000013c 
0000013£ 


00000142 
00000144 
00000147 
0000014a 


00000144 
00000150 


00000153 
00000156 
00000159 
0000015c 


0000015f 
00000163 
00000166 
000001l6a 
0000016d 
00000171 
00000175 
00000177 


00000179 
0000017b 
00000174d 
0000017£ 


00000181 
00000185 
00000188 
0000018c 
0000018f 
00000193 
00000197 
00000199 


0000019b 
000001 9d 
0000019f 
000001 al 


000001a3 
000001a6 
000001a9 
000001lac 


e540c3 
e5c520 
e54020 


340 

e62040 
d6c340 
d62040 


d735 

£540c3 
£5520 
£54020 


873540 
975340 


473ec5 
473e40 
475£c3 
475£20 


a7 340004 
e73440 


b7520004 


£75240 
b7500020 
a7500040 
0334 
d352 


e234 
e334 
£252 
£352 


a7 350004 
e73540 
b7530004 
£75340 
b7510020 
a7510040 
¢335 


d353 


e235 
e335 
£253 
£353 


c4c4c2 
c440c2 
c4.c420 
c44020 


163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 


185 


186 
187 


188 


189 
190 
19t 
192 
193 
194 
195 
196 
197 
198 
199 
200 


201 . 


202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 


217 


ldb 
ldb 
ldb 
ldb 


ldc 
ldc 
ldc 
Idec 
lde 


-lde 


ldc 
ldc 


ldcd 
ldei 
ldepd 
Idepi 


lde 
lde 
lde 
lde 
lde 
lde 
lde 
lde 


lded 
ldei 


ldepd 
Idepi 


ldw 
ldw 
ldw 
ldw 


13 , G64 
32 ,@r5 
32, @64 


13, #64 
32, #64 
@r3, #64 
C32, #64 


@r3 ,r5 
@r3 64 
@32 ,r5 
@32 64 


r3 ,64(r5) 
64(r3) ,r5 


r3,r5,#7 
r3 ,64, #7 
r3,#7 ,r5 
32,#7 ,r5 


r3,,1024(rr4) 
r3,64(rr4) 
1024(rr2),r5 
64(rr2) ,r5 


32 ,4r5 
r5,64 
r3 ,@rr4 
@rr2,r5 


r3,@rr4 
r3 ,@rr4 
@rr2 ,r5 
@rr2,r5 


r3,1024(rr4) 
r3,64(rr4) 
1024(rr2),r5 
64(rr2),r5 


32,r5 
65,64 
r3,@rr4 
@rr2,r5 


r3,@rr4 
r3 ,@rr4 
@rr2,r5 
@rr2,r5 


rr2 ,rr4 
rr2 ,64 
32 ,rr4 
32 ,64% 
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QO0000Laf c5c4c2 218 ldw rr2,@r4 
000001b2 ¢540c2 219 ldw rr2,@64 
000001b5 ¢5c420 220 ldw 32 ,@r4 
000001b8 ¢54020 221 ldw 32 ,@64 
222 
000001bb c6c20400 223 ldw rr2, #1024 
QO0001 bf c6200400 224 ldw 32 , #1024 
225 
000001¢3 84¢5c2 226 mult rr2,r5 
000001c6 8440c2 227 mult re2, 64 
000001¢9 84c¢520 228 mult 32,r5 
00000lece 844020 229 mult 32 ,64 
OO000lc£ 85ce5c2 230 mult rr2,@r5 
000001d2 8540c2 231 mult rr2,@64 
00000145 85520 232 mult 32 ,@r5 
000001d8 854020 233 mult 32,@64 
000001db 8640c2 234 mult rr2,#64 
00000lde 864020 235 mult 32, #64 
236 
00000lel OF 237 next 
238 
o0000d0le2 ff 239 nop 
240 
000001e3 4235 241 or r3,r5 
000001e5 4335 242 or r3 ,@r5 
000001le7 4440c3 243 or 13,64 
00000lea 44c¢520 244 or 32,45 
000001led 444020 245 or 32,64 
000001£0 4540c3 246 or r3 ,@64 
000001f3 45520 247 or 32 ,@r5 
000001f6 454020 248 or 32 ,@64 
0000019 46340 249 or 13, #64 
000001lfe 462040 250 or 32, #64 
251 
000001 FE 50c3 252 pop r3 
00000201 5020 253 pop 32 
00000203 51c3 254 pop @r3 
00000205 5120 255 pop @32 
256 
00000207 92c5c3 257 popud 1r3,@r5 
0000020a 9240c3 258 popud r1r3,@64 
00000204 92520 259 popud 32,@r5 
00000210 924020 260 popud 32,064 
261 
00000213 93c5c3 262 popui _r3,@r5 
00000216 9340c3 263 popui 13,@64 
00000219 93520 264 popui 32,@r5 
0000021¢ 934020 265 popui 32, @64 
266 
O000021£F 70c3 267 push x3 
00000221 7020 268 push 32 
00000223 71c¢3 269 push @r3 
00000225 7120 270 push @32 
271 
00000227 82¢3c5 272 pushud @r3,r5 
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0000022a 
0000022d 
00000230 


00000233 
00000236 
00000239 
0000023¢ 


000002 3f 
00000240 
00000242 


00000243 
00000245 
00000247 
00000249 


0000024b 
0000024d 
000002 4f 
00000251 


00000253 
00000255 
00000257 
00000259 


0000025b 
00000254 
0000025f 
00000261 


00000263 
00000264 


00000265 
00000267 
00000269 
0000026c 
0000026f 
00000272 
00000275 
00000278 
0000027b 
0000027e 


00000281 
00000282 


00000284 
00000286 


82¢340 
8220c5 
822040 


83¢3¢5 
83340 
8320c5 
832040 


cf 
d5a5 
af 


90c3 
9020 
91c¢3 
9120 


10c3 
1020 
11c3 
1120 


e0c3 
e020 
elc3 
e120 


c0c3 
c020 
ele¢3 
e120 


Af 
5£ 


3235 

3335 

3440c3 
34¢520 
344020 
3540c3 
35¢520 
354020 
36c340 
362040 


df 
d0c3 


d020 
dlc3 


273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 


303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 


pushud 
pushud 
pushud 


pushui 
pushui 
pushui 
pushui 


ref 
rdr 
ret 


rl 
rl 
rl 
rl 


tle 
rlc 
rle 
rlc 


rr 
rr 
rr 
Tr 


rre 
rre 
rre 
rre 
sb0 
sbl 


sbe 


_sbe 


sbc 
sbc 
sbe 
sbe 
sbe 
sbe 
sbec 
sbc 


scef 
sra 


sta 
sta 


@r3 ,64 
@32,r5 
@32 ,64 


@r3 ,r5 
@r3 64 
@32,r5 
@32 ,64 


#0a5h 


r3 
32 
@r3 
@32 


r3 
32 
@r3 
@32 


r3 
32 
@r3 
@32 


r3 
32 
@r3 
@32 


r3,r5 
r3 ,@r5 
r3,64 
32 ,4r5 
32,64 
r3 ,@64 
32 ,@r5 
32 ,@64 
r3,#64 
32, #64 


r3 
32 
@r3 
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00000288 d120 328 sta @32 
329 
0000028a 3180 330 Srp #128 
0000028c¢ 31381. 331 srpl #128 
0000028e 3182 332 srpO #128 
333 
00000290 2235 334 sub r3,r5 
00000292 2335 335 sub r3,@r5 
00000294 2440c3 336 sub 13,64 
00000297 24¢520 337 sub 32:7) 
0000029a 244020 338 sub 32 ,64 
0000029d 2540c3 339 sub r3 ,@64 
000002a0 25¢520 340 sub 32 ,@r5 
000002a3 254020 341 sub 32 ,@64 
000002a6 26c340 342 sub r3,#64 
000002a9 262040 343 sub 32, #64 
344 
000002ac f0c3 345 swap = r3 
000002ae £020 346 swap 32 
000002b0 £1c3 347 swap ¢@r3 
000002b2 £120 348 swap  @32 
349 
000002b4 6235 350 tcm r3,r5 
000002b6 6335 351 tem r3 ,@r5 
000002b8 6440c3 352 tem r3 ,64 
000002bb 64c520 353 tem 32 ,r5 
000002be 644020 354 tcm 32,64 
000002cl 6540c3 355 tcm r3 ,@64 
000002¢4 65¢520 356 tcm 32 ,@r5 
000002c7 654020 357 tem 32 ,@64 
000002ca 66c340 3538 tcm r3, #64 
000002cd 662040 359 tem 32, #64 
360 
000002d0 7235 361 tm 6337) 
000002d2 7335 362 tm r3 ,@r5 
363 
000002d4 7440c3 364 tm r3,64 
000002d7 74c520 365 tm 32,r5 
000002da 744020 366 tm 32,64 
000002dd 7540c3 367 tm r3 ,@64 
000002e0 75520 368 tm 32 ,@r5 
000002e3 754020 369 tm 32 ,@64 
000002e6 76340 370 tm 13, #64 
000002e9 762040 371 tm 32, #64 
| 372 
000002ec b235 373 xor r3,4r5 
000002ee b335 374 xor r3,@r5 
000002£0 b440c3 375 xor r3,64 
000002f£3 b4c520 376 xor 32 ,r5 
000002f6 b44020 377 xor 32,64 
000002f9 b540c3 378 xor r3 ,@64 
000002fe b5¢520 379 xOr 32 ,@r5 
O00002Ff b54020 380 xOL 32 ,@64 
00000302 b6c340 381 xor r3,#64 
00000305 »b62040 382 xor 32, #64 
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00000308 


00000309 
0000030b 
0000030d 
0000030£ 
00000312 
00000314 
00000316 
00000319 
0000031b 
0000031d 
0000031£ 
00000321 
00000323 
00000325 
00000327 
00000329 
0000032 b 


0000032d 
0000032£ 
00000331 
00000333 
00000335 
00000337 
00000339 
0000033b 
0000033d 
0000033 f 
00000341 
00000343 
00000345 
00000347 
00000349 
0000034b 
0000034d 
0000034f 
00000351 
00000353 
00000355 
00000357 
00000359 
0000035b 
0000035e 
00000360 
00000362 
00000365 
00000367 
00000369 


38de 
38dd 
38de 
c4dac2 
38db 
38da 
c4d8 2 
38d9 
38d8 
38d7 
38 d6 
3845 
38d4 
38d3 
38d2 
38dl 
38d0 


38ff 
38 fe 
38fd 
38fce 
38fb 
38fa 
38 £9 
38 £8 
38£7 
38 £6 
38f£5 
38£4 
38f1 
38d1 
38 £0 
38ed 
38ec 
38eb 
38ea 
38e9 
38e8 
38e7 
38 e6 
c4e4c2 
38e5 
38e4 
c4e2c2 
38e3 
38e4 
38el 


383 
384 
385 
386 


388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 
423 
424 
425 
426 
427 
428 
429 
430 
431 
432 
433 
434 
435 


437 


wfi 


E-15 


;defined register names 


r3,sym 
r3 ,imr 
r3,irr 
rr2,ip 
r3,ipl 
r3,iph 
rr2,sp 
r3,spl 
r3,sph 
r3,rpl 
r3,rp0 
r3,flags 
r3,p4 
r3,p3 
r3,p2 
r3,pl 
r3, pO 


; Bank O Special Registers 


r3,ipr 
r3,enmt 
r3,p2bip 
r3,p2aip 
r3,p2dm 
r3 ,p2cm 
r3 ,p2bm 
r3 ,p2am 
r3 , p4od 
r3 ,p4d 
r3,hle 
r3,hOc 
r3, pm 
r3,pl 
r3 , pOm 
r3,uie 
r3,urc 
r3 ,utec 
r3,sio 
r3,sie 
r3,srcb 
r3,srca 
r3,ste 
rr2,cle 
r3 ,clel 
r3 ,clch 
rr2,c0c 
r3,cOcl 
r3,celch 
r3,elct 
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0000036b 


0000036d 
O0000036£ 
00000371 
00000373 
00000375 
00000378 
0000037a 
0000037c 
0000037€£ 
00000381 
00000383 
00000386 
00000388 
0000038a 
0000038c¢c 
0000038e 
00000390 
00000392 
00000395 
00000397 
00000399 
0000039c 
0000039e 
000003a0 
00000343 
000003a5 
000003a7 
000003a9 


000003ab 
000003ad 
000003af 
000003 bl 
000003 b4 
000003 b6 
000003 b8 
000003 bb 
000003 bd 
000003bf 
000003 cl 
0000033 
000003c5 
000003c7 
0000039 
000003c¢b 
000003cd 


Q00003cE£ 


38e0 


38f£ 
38 fe 
38fb 
38fa 
c4£8c2 
38£9 
38£8 
c4£0c2 
38f1 
38£0 
c4eec2 
38ef 
38ee 
38ed 
38ec 
38eb 
38ea 
c4e8c2 
38e9 
38e8 
c4e4c2 
38e5 
38e4 
c4e2c2 
38e3 
38e2 
38el 
38e0 


38de 
38dd 
38dc 
c4dac2 
38db 
38da 
c4d8e2 
38d9 
38d8 
38d7 
38 d6 
38d5 
38d4 
3843 
38d2 
38d1 
38d0 


38£f 


438 
439 
440 
441 
442 
443 
444 
445 
446 
447 
448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 
459 
460 
461 
462 
463 
464 
465 
466 
467 
468 
469 
470 
471 
472 
473 
474 
475 
476 
477 
478 
479 
480 
481 
482 
483 
484 
485 
486 
487 
488 
489 


ld 


;upper case 


ld 
1d 
1d 
ldw 


test 


r3,cOct 


; Bank 1 Special Registers 


r3,wumsk 
r3 ,wumch 
r3, umb 
r3,uma 
rr2,ubg 
r3,ubgl 
r3,ubgh 
rr2,dc 
r3,dcl 
r3,dch 
rr2,syn 
r3,synh 
r3,synl 
r3 ,smd 
t3,smc 
r3,smb 
r3,sma 
rr2,sbg 
r3,sbgl 
r3,sbgh 
rr2,cltc 
r3,cltel 
r3,eltch 
rr2,cOte 
r3 ,cOtcl 
r3,cOtch 
r3,clm 
r3 ,cOm 


r3,SYM 
r3, IMR 
r3,IRR 
rr2,IP 
r3,1PL 
13, IPH 
rr2,SP 
r3,SPL 
r3,SPH 
r3,RP1 
r3,RPO 
r3, FLAGS 
r3,P4 
r3,P3 
r3,P2 
r3,Pl 
r3,P0 


490 ; Bank O Special Registers 


491 
492 


ld 


r3,IPR 
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Na TT SS TSEC OA TS TESTES ISS IE a Se RE Ts st NEST, 


000003d1L 
00000343 
000003d5 
000003d7 
00000349 
000003db 
000003dd 
000003d£ 
000003el1 
00000363 
000003e5 
000003e7 
000003 e9 
000003eb 
000003 ed 
000003ef 
000003 £F1 
000003£3 
000003£5 
000003£7 
000003£9 
000003£b 
000003f£d 
00000400 
00000402 
00000404 
00000407 
00000409 
0000040b 
0000040d 


000004 0F 
00000411 
00000413 
00000415 
00000417 
0000041la 
0000041¢ 
000004le 
00000421 
00000423 
00000425 
00000428 
0000042a 
0000042c 
0000042e 
00000430 
00000432 
00000434 
00000437 
00000439 
000004 3b 
0000043e 


38fe 
38 fd 
38fc 
38f£b 
38fa 
38£9 
38 £8 
38£7 
38 £6 
38£5 
38£4 
38f1 
38dl1 
38£0 
38ed 
38ec 
38eb 
38ea 
38e9 
38e8 
38e7 
3866 
c4e4c2 
38e5 
38e4 
c4e2¢2 
38e3 
38e2 
38el 
38e0 


38ff 
38fe 
38fb 
38fa 
c4f8c2 
38 £9 
38 £8 


c&£0c2 
38f1 


38£0 
c4eec2 
38ef 
38ee 
38ed 
38ec 
38eb 
38ea 
c4e8c2 
38e9 
38e8 
c4e4c2 
38e5 


493 
494 
495 
496 
497 
498 
499 
500 
501 
502 
503 


505 
506 
507 
508 
509 
510 
511 
512 
513 


524 


ld 
1d 
ld 
ld 
ldw 


r3 , EMT 
r3,P2BiP 
r3 ,P2AIP 
r3,P2DM 
r3 ,P2CM 
r3 ,P2BM 
r3 ,P2AM 
r3,P40D 
r3,P4D 
r3,HIC 
r3 , HOC 
r3, PM 
r3,Pl 
r3, POM 
r3,UIE 
r3 ,URC 
r3,UTC 
r3,SI0 
r3,SIE 
r3,SRCB 
r3,SRCA 
r3,STC 
rr2,Cl1C 
r3,C1CL 
r3 ,C1CH 
rr2,COC 
r3 ,COCL 
r3,COCH 
r3,C1CT 
r3,COCT 


; Bank 1 Special Registers 


r3 , WUMSK 
r3 ,WUMCH 
r3,UMB 
r3 ,UMA 
rr2 ,UBG 
r3 ,UBGL 
r3 ,UBGH 
rr2 ,DC 
r3,DCL 
r3 ,DCH 
rr2,SYN 
r3 , SYNH 
r3,SYNL 
r3 ,SMD 
r3,SMC 
r3 , SMB 
r3,SMA 
rr2 ,SBG 
r3,SBGL 
r3 , SBGH 
rr2,C1TC 
r3,CLTCL 
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00000440 38e4 548 1d r3,CI1TCH 

00000442 c4e2c2 549 ldw rr2,COTC 

00000445 38e3 550 1d r3,COTCL 

00000447 38e2 551 ld r3,COTCH 

00000449 38el 552 1d r3 ,C1M 

0000044b 38e0 553 1d r3,COM 
554 
555 ;test for condition codes 
556 

0000044d 0d0080 557 ip f,128 
558 

00000450 6d0080 559 jp z,128 

00000453 ed0080 560 ip nz,128 

00000456 6d0080 561 ip eq,128 

00000459 ed0080 562 ip ne,128 
563 

0000045c 7d0080 564 ip ¢,128 

0000045f £d0080 565 ip nc,128 
566 

00000462 ad0080 567 ip gt,128 

00000465 1d0080 568 ip 1t,128 

00000468 9d0080 569 ip ge,128 

0000046b 2d0080 570 jp le ,128 
571 

0000046e dd0080 572 ip p1,128 

00000471 5d0080 573 ip mi,128 
574 

00000474 «d0080 575 jp nov,128 

00000477 4d0080 576 jp ov ,128 
577 

0000047a bd0080 578 jp ugt,128 

0000047d 7d0080 579 ip ult ,128 

00000480 £d0080 580 ip uge,128 

00000483 3d0080 581 jp ule ,128 
582 
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Chapter 1 
INTROOUCTION 


41-1. OVERVIEW 
1e1-1-2 Product Overvies 


The Universal Object File Utilities are part of Zilag’s 
MUFCM~output cross-software family. The utilities allow the 
programmer to combines displays and load aachinerlanguage 
object modules. The utilities are universal because they 
can process object modules produced by any of Zilog’s 
MUFOM~outout cross~-assemnblers. 


MUFCM is an acronym for Microprocessor Universal Format § for 
Object Modules. MUFOM was developed by the IEZE as a format 
for representing machinerlanguage object modules for any 
microprocessor. By using the MUFOM object formats Zilog 
supports all its assemblers (Cand compilers) using only one 
set of programss the Universal Object File Utilities. 


1ete2- Manual Overvies 


This manual provides the following information: 


re) A brief description of the program’s features. 

° A complete definition of the command line syntax. 

° A complete definition of the utilities’ functions. 

° Tutorials for the more complex portions of the utili- 
ties. 

re) A complete definition of the input file format. 

° A complete definition of the output file fornat. 


Section 1.2 briefly describes the utilities and their usess 
and Section 1.3 describes how to invoke the utilities anda 
the general command line syntax. 


Chapters 2 through 10 discuss each utility in turn. within 
each chanter comnand syntaxs feature descriptionss and exam 
ples are provided. Chapter 11 describes three special- 
purpose programs which are elso supplied with the utilities. 


Appendix A provides a discussion of ard specifications for 
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the MUFOM objact file format. Appendicas 8 and C discuss the 
Tektronix Hex fornat and Intel Hex formats respectively. 
Appendix 3 lasts the error messages. 


Appendix — is the glossary. You do not naed to understand 
the MUFCM osbject-file format to use these utilities. There 
ares howevers a number of terms used when discussing MUFOM 
products that you should understand. These terms are 
defined in Appendix =. It is suggested that you familiarize 
yourself with these terms before continuing with the rest of 
this User’s Guide. 


1e2- UTILITIES OESCRIPTION 


This section presents a brief description of each utility 
and its usage. Figure 17-1 shows how the utilities fit into 
the software development process. 


Te2ete acony 


meony is an object format converter. It converts object 
modules from MLFOM ASCII format to MUFOM binary format and 
vice versa. 


1e2e2eo adunmp 


nodumep is the object code dumper. It displays information 
about an object modules its sectionss and its load data in 
humancreadable form. 


1eZede mlib 


mlib is the object-code library maintenance utility. It 
allows object files to be combined into libraries which can 
be automatically searched by glink. 


Ve2ehe alink 


mlink is a relocating linker. It accepts an arbitrary 
number of input files (limited only by available memory), 
resolves external references between files, combines file 
sections, and locates sections at absolute addresses. glink 
also generates relocatable output moculas which can be re- 
linked later. 


Zilog Object File Utilitias 1-2 


INTRODUCTION Chapter 1 INTROOUCTION 


1250 nlist 


list is the objact code lister. It reconstructs an 
essemblerrlike listing from an object nodules using special 
comments which are optionally inserted in the object module 
by the assembler. 


1e2e6e mload 


migzd is a download format converter that translates MUFOM- 
format object modules into a form suitable for transmission. 
(downloading) to development modules, emulators, or PROM 
progranmers. The output formats suoported are Tektronix 
Hexs Intel dexs and a sinplified form of M4UFOM. migad is 
intended to be used with protocol] or a similar communication 
Programe 


1.2.7. miorder 

Ix mlorder examines a set of object files to determine the 
optimum ordering for them in a library files which can then 
be constructed using gohib. 

1.2686 ANnMm 

gop is the object module symbol lister. It displays infor- 
mation about the symbois within an object module. 

1.2<9- protocol 

ecetocol is a communicétion utility for transmitting files 
(typically load modules generatad by mload) from a develop- 
nent host system to a target systen (downloading) or vice 
versa (Cuploading). It supports a variety of handshakes to 
provide relieble transmission. 

1.2.10. Other Programs 

Three other programs are supplied with the Object File Util- 
ities, they ars intended for rather specialized purposes and 
will not be needed by most users. 


122210.1. aar 


mac is an older version of mlibs producing an archiye file 
which is compatible with the previous release of glirk. 
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12-2210.2. ada 


Mga converts MUFOM files to a.gyt form, the object fila for- 
mat used on Zilog’s S80O0G microcomputers. This is provided 
for users of Zilog’s EMS-8000 emulatorss which use that for- 
mat for downloading. 


1-2210.3. muimage.c 


Muimas@-¢ is a MUFOM loader provided in source form for user 
customization. 


~~ 
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Figure 1-1. The Universal Gbhject File Utilities in the 
Software Development Process 
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1.3. UTILITY INVOCATION 


This section describes the invocation of tha orjact file 
utilities. The synrtectic notations used in this section and 
throughout the rest of the manual are described below. 


tesete Syntactic Notation. 


Citemn) 
Square brackets indicate that the item is optional. 


item1 | item2 
A vertical bar indicates that either of the two items 
can be provided. 


item aee 
Three periods indicate that there can be one or more 
occurrences of tha preceding ita. 


item * 
An asterisk indicates that there can be zero or more 
occurrences of the preceding item. 


N stands for a aoecimal number. 


H stands for a hexadecimal number. 


1.3.22 Command Invocation 


Each utility is a separate programs, invoked by using its 
name as a command. The command nama is followed by zero or 
more “arguments” separated by spacess command arguments may 
be filenaness numberss or so-called “options"™. 


Command line syntax follows the UNIX* convention in which a 
“=” sign followed by a one-character option identifier Cwith 
no intervening spaces) is parsed as an option (e.gesr “O)- 
Cotions can aprear in any order. Case is not significant in 
option identifiers, they may be uppercasa or lowercase 
letters. 


Some options may be followed by a number or filename. A 
space is gptignal between the option letter and the number 
or filename, and reguiced following it. 

* UNIX is a trademark of AT &3 T Bell Leboratorias; 
Zilog is licenced by AT&T Technologiess Inc. 
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Cretion characters may be concatenated Ce.ge.2 two options, 
such as “a and bs can be written as -ab)s provided the 
first option (-a in this example) does not expect to be fol- 
lowed by a number or filename. 


For examples the command 

mlink ~i 00.0 ~ofoo -rz 
illustrates most of these principles: The “i and -0 options 
are each followed by a filename (foo.0o for “47 foo for -o. 


The two single-character options “fF and -z2 are combined as 
=“PZe 
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MCONYV 


2ete INTRODUCTION 

The moony wtility is a filter that converts an object module 
from one format to another. MUFOM object files can be in 
either ASCIY character or binary form. Cbhject modules in 
binary form save spaces while character form allows easy 
examination and reading by the users and is nore useful for 
downloading over serial links. 

2e2Ze COMMAND SYNTAX AND OPTIONS 


The gecony conversion utility is invoked by the following 
commands 


mceonv Coptionsj Cfile] 


If no input file is specified, standard input is converted. 


The command-line options ares: 
-b Convert the source to binary form. 


=¢ Convert the source to character forms this is. the 
default option. 


-1 Retain local symbols in the output. If this option is 
not supplieds only global and external symbols will be 
listed. 

“-k N Retasin MUFOM comments up to level N in the output. 

-o file 


Direct output to the given file rather than to standard 
output. 
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3e1- INTROOUCTION 

The adygo utility is used to display MUFOM object code in a 
user-friendly format. It accepts MUFOM objact modulas as 
input and can output four items of informations the abject 


module headers the section tables the link naps and the load 
data, 


3e2e COMMAND SYNTAX AND OPTIONS 
The commana syntax for this utility is as follows: 
mdump Coptions] CfileJ 
If no file is specified,s then the standard input will be 
dumped. 


The command-line options are: 


“h Oisplay the header information. 
=1 Oisplay the load data. 

—m Display the link map. 

“-s Display the section table. 


If none of chs “le -ms or ~-S is givens all information is 
displayed. 


-o file 
Direct output to the given file instead of standard 
output. 


“kk oN 
Peint the MUFOM comments within the object module with 
@ level less than or equal to Nw Sew Appendix A for a 
discussion of MUFGM comments. 
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3-3-2 OISPLAY FORMATS AND EXAMPLES 


This section describes the formats of the four items of 
information in mdyme’sS output. They may ba individually 
selected for display by command-line optionss by default all 
four items are output. 


Zesete The Header 
The first part of gdympe’s output is & header containing gen- 


eral information about the module. The header information 
includes: 


) Module name 

° Target processor 

° Character/B8inary format 

° Address length and byte order 

) Creation date and time 

° Absolute/Relocatable 

° Entry point 

fr) Program size (in hex and decimal) 


A typical module neader is shown below: 


Modules tests target Z80K> character form. 
Address length 4 bytess MS8 first. 
Created 1986/04/02 09:35:38. 

Entry point = O0000C01. 
Total size = e258 (3672) absolute. 


3adele The Section Table 


Following the headers mdump lists a table of all the seco- 
tions in the object modules as shown in the two examples 
below. Note that some fields may be blank if no values have 
been set for them. In particulars the LOCATION field is 
blank for relocatable sections. 
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SECN LOCATION =~SIZE=- --ALIGN~ ~~PAGE=— NAMESATTS 
0 O0000d4a 00900002 : 
1 00000614 O00C0G0G62 secl_name: 
2 cCoo0ocgcdOa 00000002 secesxP 
3 OC0d00G2 00000004 sec3: 
4 ococoegce CO0000Ce code :X 
5 00000006 00000002 datas: 
6 OocoociGc o00C0002 bss: 8CW 
7 00901000 00000014 90000002 abs:A 
8 ooococos 900Ca002 comm:M 
SECN LOCATION ~~SIZEsw= “-~ALIGN= *~-PAGE-= NAMESATTS 
0 00000090 00000166 00000002 COC1CO0O allfoo:ANSw 
41 00005000 O0000092e libcode:ANSX 
2 00005000 COoo000Té6O OOCCOOGD2 O0010C00 code:zANSx 
3 90905060 O90000fO 00000002 00000000 Ccommon:sABNSh 
The SECN column displays the section number. Fach section 


has anumber associated with it that differentiates it from 
the other sections in the object module. The LOCATION 
column displays starting address (lower boundary) of the 
section. If the section is relocatabie then the LOCATION 
column’s entry will be blank. The SIZE column shows the 
size in hexadecimal of the section. The ALIGN and PAGE 
columns show the alignment boundary and page size of the 
sections if defined. 


The NAMESATTS column shows the name and attributes of the 
sections separated by a colon. See Section 5.2.2.4 in the 
chapter on pliok for a discussion of section attributes and 
their meanings. 


33030 The Link Map 


Object modules that are output by the linkers glinks contain 
information about the files and sections that were linked 
together to form them. This information is called the Link 


Mep,s and is identical to that displayed by the ~v option of 
Mhink. 


If no Link map is presents mdump displays the message 


No link map information. 
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An example of a link map is shown below: 


LINK MAP: Input Sections 

FILE test.o created 1986/03/24 09:46:36 

L=COOCO006 $=909000d4a teast.ors ANSw 

L=00000a7e S=0C0CO0014 test.orssect_ namezANSw 

L=00000074 S$=0000000a test.orseccsAPSX 

t=00000d94 S=CO000002 test.ovseac3:ANSw 

L=909C00d6& S=000000Gc test.orscode:ANSX 

t=00000000 S=COSO000CE testeordatazANSw 

L=000010bc S=Q0000001C test.o-bsssAaCNW 

t=00001096 S$=30000014 test.orabss ANSW 

L=00001014 S=00000002 test.o,comm:AMNW 

txxxe0 created 1985/10/21 14:53:08 
2 tz000C0dSC $=000009010 txxxeorsANSw 
8 1£2=00001614 S=000C0054 txxx.orscomms AMNW 


One OWA UA 


FILE 


= © ONOUFWN ~~ © 


Note that the link map includes the name and creation date 
of each fila that was linkeds if the file came from a 
iibraryr the library name follows the filename in 
parentheses. 


The line for aach input file is followed by e@ line for each 
section that the file containss the first two columns are 
the input and output section numberss respectively. 

For relocatable sections, “L=" is replaced by “R="s and tha 


associated location is the offset of the input section 
within the (possibly larger) output section. 


ee ee The Load Data 


The Load Data is the data and code that will actually be 
loadad into the target machine’s memory. 


Tne data is displayed in the format shown below: 


Section number 


addrass3  -s7-~--object codercrrr r= [ASCII equivalent] 
address: 7 -""----object code~------7> [ASCII equivalent| 
etc. 


The load data is broken up into lines for displays each of 
which can show up to sixteen bytes of data. The display 
lines are aligned on modulo-16 byte boundaries with the 
address being the address of the first byte actually 
displayed. If the section is relocatable then the address 
is relative to the beginning of the section. If the section 
is absolutes then the address is the actual nsosition in 


Zilog Cbject File Utilities 3-4 


MOUMP Chapter 3 MOUMP 


Me NOP Yo 


Exemnple: 


J0999000 Se 0@ 50 54 a1 7e al 6d at Sc Ed ch Se De 59 16 1* °F “ m \ 


SCO00019 83 22 Se 08 SO 4a ab c0 Gb Ge GO OC Se C2 SO 3c jp “* PJ 
occcoo2e 20 eC Ca dG 5e Oe 50 3c Oc e4% Se Oe 5C 34 83 22 oe 
09000030 S5e 08 50 4% a9 eD a9 dO Se 08 53 16 20 ea bt 20 1* OJ ~ oR 
00990049 209 d8 b1 OG &3 O2 5e O08 SC 4a Sc fF1 Qe O2 CO CO { a Ps 
JC990G50 a9 £5 Fo 0&8 ab F5 5c F9 De D2 9I 0D 5e 08 50 04 ] \ 


3Ze3e54 Disjoint Sections 


It is important to note that the MUFCM format allows the 
object code for a section to be broken up into physically 
disjoint pieces. If pieces of sections are distributed ran- 
aqomly throughout the object modules mdunp will not be able 
to display each section contiguously. 

Instead,s mdump will display the pieces of the sections 

as it receives them from the input file. The example below 
shows the load dat& of a module with two sectionss eacn 
split into two pieces. 


Section 0 

OoocoCOO 61 62 63 64 Jabed 
Section 1 

00900000 30 32 33 34 35 102345 
Section OQ 

OCO00004 65 66 67 68 | efgh 
Section 1 

990090905 36 27 38 39 | 4785 


Sections can also contain gaps (ceused by assembler state- 
ments that reserve space without initializing it). Short 
gaps are represented by "“sesece” within a single lines long 


gaps by “seen” in the address fielas zs shoun below: 


COOO0CO0O O01 C2 C3 wccccccceee 04 O05 UG 


OCOCTOSe 08 OF 


33064 Displaying Relocation Information 


within MUFOM erelocsteble object codes raferences to 
unresolved external symbols and to locéetions in relocatable 
sections are represented 8S expressions. The formats usea 


Cad 
i) 
ea] 
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for displaying expressions are shown below: 


Rnntoffset relocatable address 
Xnntoffset external refsrance 
kakkhkkkekk other expressions 


The expressions are padded with periods to occupy the 
appropriate amount of space (three columns per byte). If 
there is insufficiént space for the whole expressions it is 
abbrevieted to its first letter and paddea with periods. 
The following example illustrates all three fornats. 


coo0cood R141 234ece0 XO+1 234. cee Reennveaesacea 


If mecessarys more detail about an expression can be 
obtained by running glist, which can expand expressions com- 
pletely. 
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4.1. INTRODUCTION 


The mjib utility is used for creating and meintaining 
libraries of object modules for use with mjink. Libraries 
are stored in a forn that permits efficient searching and 
linking of the modules they contain. 


4.2. COMMAND SYNTAX AND OPTIONS 


The glib conversion utility is invoked by the following com- 
mands 


mlib key lfile ECnamej... 
Key is one character from the set "drtaxf" optionally fol- 
lowed by "v". Jfile is the library files the names are the 


constituent files in tha library. 


Note that a “key"™ is not an “option”, it has no leading “-" 
character. The meanings of the key characters are: 


d Delete the named files from the library file. 
r Replace the named files in the library file. 
q Cuickly append the named files to the end of the 


library files without checking whether they ara already 
in the library. 


t Print a table of contents of the library file. If no 
names are givens all files in the library ares tabled. 

x Extract the named files from the iibrary. If no names 
are givens all files in the library area extracted. The 
library file itself is not altered. The extracted 


files are put into the current working directory. 

v Verbose. Gives more information -about what mlib is 
doing. With <t¢ this includes @ listing of the symbols 
in each module as well as the names of the moaulgs. 


f The farst and only “name” in the command line is the 
name of a file which contains the list of filenames. 
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4e3- EXAMPLES 


To combine severai files (says “filet.o", "“file2.o” and 
"“€jile3.0"%) into a librarys use the command: 


mlib aq foo.lib filet.o file2.o file3.o 
If one of the files is modifieds it can be replaced with the 
commands 


mlib r foo.lib filez.o 


To edd another file to the librarys use 


mlib q fooelib file4.o 


To find out what is in the librarys use 


mlib t foo.wlib 


To break the library into separate filess use the command 
mlib x foo.elib 


Note that the library file is unaffected by this operation. 
A single file can be extracted with the command 


mlib x fooelib file2.o 
If a filename containing a list of filess say “bar",s, has 
been prepared (for example as the output of glorder)s, we can 


use it to create 2 library with the command 


mlib af bar.lib bar 
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Se1. INTROOUCTION 


The mlink utility is used to assign absolute addresses to 
relocatable sections in MUFOM input moduless and to combine 
(link) two or more separate object modules into one module. 
Linking allows programs to be developed as groups of 
smallers sasier-tommanage modules that can then be combined 
to form a single object module. All of a program’s modules 
can be merged at one time or they can be combined into sub- 
modules (sometimes called pre-links) which can themselves be 
combined in a subsequent glionk run. 


S.1.-1- Modules And Sections 


in order to understand the linking process, it is useful to 
understand the way in which MUFOM files are constructed. 
(The following discussion is a shortened version of that 
found in Sections Ae2 and Ae3 of the Appendix on MUFOM. See 
the Appendix for more detail.) MUFOM object files are 
divided into sections each of which is destined to be loaded 
into a separate area of mamory. Each saction has @ nane, a 
size, attcibytes,s and (if not relocatable) a location. Each 
section also has a sgecgtion nugber which is used to refer to 
it internally. In Zilog’s implementation these section 
numbers correspond to the order of the sections in the secn- 
tion table. (See Section A.2 in the Appendix on MUFOM for a 
discussion of the various section attributes and their mean- 
ings.) 


It is important to note that the name of a section may be 


null Cin which case the section is referred to as 
*unnamed™"), and that the names of sections need pet be 
unbigue.e Thus, a file may contain several sections named 


"code". The advantage of this is that the linker can relo- 
cate such sections separatelys thus on 2a 728001 not all 
*"code” sections have to be in the same segment. 


Sections can be referenced in the linker by either their 
mane, their attributess or the name of the file from which 
they ceme. 


MUFOM object files as implemented at Zilog are divided into 
threa regions: a section table giving all information about 
the file’s sections except their actual contents, a symbol 
table which defines the Ns Ie and X variables which 
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represent locals internals, and external symbols respec- 
tively, and finally the load data, the LO and LR commands 
which define tha actual contents of the sections. These 
regions are delimited by special MUFOM comment commands, 
separating them in this way makes the linker and other util- 
ities run faster. 


As implemented at Zilogs the Ns Iv and X variables of any 
object file are allocated contiguously starting from NOs I0, 
and XQ. The variable indexes do pote howevers necessarily 
correspond to the order of the variables in the symbol 
table. It is only guaranteed that there will be no gaps in 
the numbering. 


MUFOM permits comments (CO commands) in object filess 
Zilog’s assemblers use level C comments for error messagess 
level 1 comments for compiler~supplied debugging informa- 
tions level 2 comments for assembler source liness and lavel 
3 for assembler line numbers anda formatting information. 
This permits debuggers and other utilities Csuch as glist) 
to reconstruct the source from the object file. 


The comments that introduce the section tables symbol table, 
and section contents have levels 100C€hexds 101 and 102 
respectively. 


§.1.2. The Link Process 


The command arguments are parsed from left to right. cach 
argument is essentially a command to the linker. 


The linker maintains two lists of sections: the Inout List 
and the Output List. The ~i file@eee command-line argument 
gets sections from input files and puts them into the Input 
List. As each file is inputs its section table is processed 
to construct entries on the Input Lists and its symbol table 
is processed to resolve external references. 


The 8 command-line argument selects sections from the Input 
List and puts them into the Output List at the Current Loca- 
tion. As each section is selected it is assigned a starting 
locations and the Current Location is incremented by the 
length of the sections. 

* things are actually a little more complicated, 
assignment of location is deferred until either a -n or 

“90 option is encountered. This is done to allow the eu 
option to "“unselect” sactions. Alsors if an absolute 
section is encountered, the Current Location for the 

next section will be the location of the absolute 
section plus its size. 
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The ~o file command-line argument appends the sections in 
the Output List to a file. The output list is then cleared. 
when the code or data contained in a section is output to a 
files the values of external or relocatable references and 
link-time expressions ere substituted. 


All other arguments operate on the Output List or tha Symbol 
Table. 


After the command line is parseds the linker makes two 
passes over the input files. In the first pass,s the symbol 
and section information in each input file is read and pro- 
cessed, and an Output List is constructed for each output 
file. With each -o arguments locations are assigned to 
relocatable sections. 


At the end of the first passs any remaining sections are put 
on the Output List of the last file mentioned, locations are 
assigned to common symbolss and still-undefined externals 
are identified. 


In the second pass the output files are written. For each 
output files symbols and program data are copied from the 
input files. Link-time expressions (including relocation) 
and external references are replaced by their values during 
the copying process. 
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Se2e COMMAND LINE SYNTAX ANDO OPTIONS 
The command-line options for gliok are given belou in Table 
5-1. More complete discussions of each option are given in 
the following sections. 
The command line is processed from left to rights each 
option with its sub-arguments is essentially a connand to 
the linker. Unlike most of the other utilitiess the order 
of the command-line arguments is significant in gliok. 
Table 5-1. miink Options Summary 

Option | Description 


Input and Cutput File Cotions 


-i Cifilej* specify input files 
~o Cofile] Cisection]* specify output file 


Section Options 


-s Cisection]* select input sections 

-n Cosection) name and combine sections 
“address set location for next section 
-t address set top loc. for previous sect. 
-r relocatable sections follow 

-m N mark loc./return to mark 

“-u Cisectionl* unselect sections 


Cutput File Cotions 


-b binary format output 
-¢ character format output 
-k N keep comments in output 


Symbol Cptions 


-l discard local symbols 

-d define C comnon symbols 
-x €sym_opJ]* process external symbols 
-~g Usym_opJ* process global symbols 
-e ECvalual specify entry point 


Other Cptions 


-p proceed even if errors 
“-v CNG set varbosity leval 

-w suppress warnings 

=2 Z80930 segments 

-f file command file input 


Zilog Object File utilities 5-4 


MLINK Chapter 5 MLINK 


Se2ete Input and Output File Options 


The Input and Output options specify the input and output 
files for the link operation. If no output files are speci~- 
fieds output goes by default to “m.out”. Note that more 
than one output file can be specified. 


If no input files are specified, glink will generate an out- 
put file containing no load data. This car be useful if the 
symbol options are used to define symbols. Alsos, the sec- 
tion options can be used to creete empty sections with 
specified names, attributes, and locations. 


SeZetet. File Option Syntax 


file_opt s:= ci Cifilel* 

|] -7o Cofilel] Cisection)* 

s= object_filename | archive filename 
= object_filename 


Se2ete2e File Option Descriptions 


“i CifileJ* 
Input the specified filess putting their sections into 
the Ineput List. As each file is processeds its seco- 
tions are placed into the Input List in numerical 
order. 


A -i is assumed at the beginning of the commands so the 
following are equivalent: 


mliink -i filel.o 
miink filet.o 


If a library file is specifieds it is searched for 
modules containing global symbols that match undefined 
externals currently in the Symbol Table. If any such 
modules are founds they are added to the Input List. 


If searching a library causes any new externals to be 
edded to the symbol table, it is searched agsin. 


-o Cofilej Cisectioni« 
Appends the Output List to the given file. If no file 
is givens the sections in the Output List are thrown 
away Cbut space is still allocated for them). Note that 
more than one output file can be specifieds this 
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feature can be used for loading into different segments 
or PROMSs or for constructing overlays. 


If section specifiers are givens only those specified 
sections Cin addition to the sections in the file’s 
Outout List) are included in the output file’s section 


table. Filenames in the section specifiers refer to 
euteout files. This feature is used to ensure that 
overlays do not reference sections in mutually 


exclusive overlays. 


Selelede Automatic Section Combining 


Some section attributes specify that sactions are to Ea com- 
bined automatically in various wayse (See Section A.2.z for 
the discussion of Overlap attributes and their effects.) 
Such sections are combined when they are first encountered 
in “i Cinput) file lists, and only the sections in the 
current Input List are looked at to find sections to combine 
with. Thuss if a “i option comes after some sections have 
been selected with a -s options the sections that have 
already been selected will got be combined withs even if 
their names and attributes match those of some new sections. 
This provides a way to override the automatic section- 
combining mechanism. 


Se2e2e Section Options 


The section options allow you to specify explicitly how the 
sections input object modules are selected and positioned in 
the output modules. Sections in the input modules are kept 
in an internal structure called the Input List until 
selected by a ~s (select) option. They are then moved to 
the Output List. Sections on the Output List are moved into 
an output file when a -o (Coutput) option is encountered. 
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Selelelte Section Option Syntax 


sec_opt ::= -s Cisection]* 
| wn Cosection] 
} cwaddress 
|} wt address 
j} oor 
J} mm N 

} wu Cisectionj* 


address s:= digit Chexdigitij* 
isection s:3= (CfilenamesIfsec_namellCsatt_match) 
osection ::= Csec_namelCrattributes] 


att_match 3:= Catt term) Cteatt_termi* 
att_group 3::= Cletter |] -cletterj... 
sec_name 222 symbol | + 

attributes ::= letters 


Se2elet2e Section Option Descriptions 


-~s Cisection]* 

Select sections from the Input List and put them into 
the Cutput List. They will be located starting at the 
Current Locations which is initially zero. Sections 
matching the first “isection” in the select list will 
be put into the output list firsts sections that match 
the same "“isection” will stay in the same order that 
they had in the Input List. The section selectors are 
described in more detail below. 





If no sections are specified the entire Input List is 
selacteds except for Postpone sections (sections with 
the "P" attribute.) If Postpone sections are selected 
in other casess they are placed after all the other 
sections in the same selection. 


-n Cosectiong 

Combines all the sections currently in the Output List 
and gives them the given name (Cand attributes, if 
specified). If no section or "“sattributes” is speci- 
fied, the combined section is unnamed. If no attri~ 
butes are specifieds the new section has the default 
attributes (C:wWSN). No attributes are inherited from 
any of the constituent sections. 


“address 
Sets the Current Location to the givan address. 
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-t address 
Adjusts the base address of the last section in the 
Cutput List Cieeae the last section selected before the 
-t option) so that its top comes as close as possible 
to the given address without violating its alignment 


constraint. 

Any sactions selected after the -r argument will be 

relocatable (until the next ~address or ~t argument). 
-m N 


If this is the first time the given mark number is 
encountered, set that mark to the Current Location. 
Otherwise, set the Current Location to the value of the 
given mark. This argument is used for aligning over- 
lays. 3 


“-u Esection]* 
“Unselect” the given sectionss moving them from the 
output list back into the input list. This can be 
useds for examples to select “all but” a given section, 
or to construct a "Postpone" section which will be out- 
put later. 


Se2el2ede Section Selectors 


A section selector as used in the 8 option has three com 
ponents: a filenames a section names and an attribute-match 
specifier. Any of these may be omitteds in which case all 
sections matching the other components are selected (the 
limiting case is ~s with no section selectorss which selects 
al] sections in the Input List). 


The format of a section selector is 
filenamessecnamesattributes 


Note that no spesses ace nercnittad between the fields. Note 
also that the filename must not contain a comma (this is 
permitted only in UNIXs and is rare in any case). 


File Name 
The file name component of a section selector refers to 
the input file from which the section came. It is ter- 
minated by a comma. 


Section Name 
The section name component of a section refers to the 
name of the section as given in a MUFOM °ST*% command in 
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the input module from which it came. Sections can be 
un*nameds such sections can be selected explicitly by 
using °+’ as the section name component of a section 
selector. 


Attribute Match 
The attribute-match component of a section refers to 
the attributes as given in a MUFOM “ST*° command in the 
input module from which it came. Because sections heave 
more than one attribute, the attribute-match component 
can be rather complicated. 


The attribute-match component of a section selec- 
tor sterts with a colons and consists of zero or 
more “terms” separated by “+° signs. A section 
matches the attribute-match if it matches egny one 
of the fielas. Thuss °+* has the meaning of “log- 
ical OR". 


A term in an attribute-match consists of one or 
more letters (case is not significant), each 
optionally preceded by a °-"” sign. If a letter is 
non=nejgated in a terms the corresponding attribute 
must be efesent in a section in order for it to 
match. If a letter is negated in a terms, the 
corresponding attribute must oet be eresent in a 
section in order for it to match. Thuss letters 
(attributes) in a term are connected by “logical 
AND", and °-° has the meaning of “logical NOT". 


Note that the attributes matched by a tern may be 
® subset of the attributes which a section actu- 
ally has. 


See Section A.2 in the Appendix on MUFOM for a discussion of 
the various section attributes and their meanings. 


Se2e2ehe Default Selection 


At the end of the links any sections still in the Input List 
are selecteds and the Output List is appended to the output 
list of the last file mentioned in a 70 argument Cas if § the 
-o argument had been moved to the end of the command). If 
no -@ argument is givens the default filename is g.ipnk. 


The sections are selected in the sequence: code (X attri- 
bute), readonly data (R attributed, other non-8S5S datas C 
common and 8SS (38 attributed. The default behavior is thus 
equivalent to 
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mlink -o melnk <actual arguments> -s :X :R 2-3 =d -s 38 
Se2e3e Output File Options 


The following arguments apply to the next output, files or to 
the last output file if they follow tha last -o ‘argument. 


Se2eSete Output File Option Syntax 


ofile_opt 23= -b 


Se2eSse2e Output File Option Descriptions 


The following options apply to the output file specified by 
the next To arguments or if they follow the last *o argu- 
ments to the last output file specified. 


-b 

Put out the next output file in binary form. 
-¢ 

Put out the next output file in character form. 
~k 


In the next output files keep comments up to and 
including level N. To retain source information for 
use with glist, use ~k3. 


Se2ehe. Symbol Options 
The symbol options operate on the symbol table which is gen- 
erated in the linking process. They allow new symbols to be 


defined, or sets of symbols to be exclucied from the output 
symbol table. 


S.2e4e1. Symbol Option Syntax 
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es 


mae ane eee Gee 66 


=~} 
-d 
-x (Csym_opl* 
-g9 Csym_opi* 
-a@ Cvaluel 


sym_opt 


letterlCletter|digiti« 
Csymbol { address]j 


symbol 
value 


symbol 

+ symbol 

+ symbol = Cvalued 
+ symbol length 


Sym_op 


Se2ehede Symbol Option Descriptions 


=] 


-d 


-x Cs 


-g Cs 


Do not put Local symbols in the next output file. 


Cefine a section for any common symbols encountered up 
to this points, and select it into the Output List. 
Common symbols are used by the C compiler and other 
compilers to hold unvrinitialized data. The common sec- 
tion defined has the name “Ccommon” and the attributes 
"BNSW". 


ym_opJ* 


ym _opj* 

Process external or global symbols. swith no sym_op’s 
givens the default operation is to strip the symbols 
from al] output files. “Stripped” symbols are not 
actually removed from the internal symbol tables, but 
are marked so that they will not be output. The opera- 
tions are: 


symbol 
Strip a particular symbol. 


+ symbol 
Add a particular symbol. Externals are added as 
undefineds globals as zero. 


+ symbol = Cvalued 
Add a symbol with the given value. If the value 
1s omitteds the Current Location is used. In the 
“x arguments a weak External is constructed. A 
Weak External is an external symbol uhich receives 
the given value as a cefault if mo corresponding 
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global symbol is defined in tha link. 


+ symbol length 
Add a C-type Common symbol with the given length. 
Used in the =x argument only. 


~e CvalueJ 
Set the Entry Point to the given value (symbol or 
address). If no value is givens the default is the 
Current Location. If no 7e@ jargumant is givens the 
default is the entry point of the first input file that 
has one. If no input file has an entry points it is up 
to the loader or operating system to define one. 


Se2e5e Other Options 


The following arguments are non-positionals and apply to the 
entire link operation. 


Se2eSete Other Option Syntax 


other_opt 33:= °- 
| ov Cnumber) 
} ww 

| =z 

{| of file 


Se2eS5e2e Other Option Descriptions 


-vCnj 
“Verbose”: print information on Standard Error about 
what the Linker is doing. The optional number selects 
different levels of information: 


1 Cdefault) Output a link nap on Standard Error at 
the end of pass 1. 


2 Cutput the name of each input and output file as 
it is opened. 


3 Output information about each section as it is 
defined or selected. 


4 Output more information about input file format 
errors. 


-5 
Proceed in spite of errors. 
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-w 
Suppress warning nessagese 

~2 
Perform Z8001-type segmented address arithmetic. With 
this option in effects the next address after 100FFFF 
hex is 2000000 in other words bits 16°23 are not part 
of the address. 

-f file 


Take arguments from a file. Newlines in the file are 
treated as spaces. The file is effectively inserted 
ints the command line in place of the -f argumant. The 
file can contain comments starting with a semicolon 
C"7") character and terminatad by end of line. 


5-3. CONSTRAINTS 
All of glink’s tables are dynamically allocateds so that the 
number of symbolss sectionss and files that can be handled 
depends mainly on the amount of memory available. In addi- 
tions Zilog’s implementation of MUFOM imposes the following 
limits: 

Symbol and Section Names: 127 characters. 

Sections: 65536. 

Local Symbols: 65536. 


Global and External Symbols: 65536 total. 
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Se4e 


This section 


USING mlinks 


describes 


Chanter 5 


SOME EXAMPLES 


the 


through several examples. 


Sebete 


For the purposes of most of the following oxampless we 
files called “filei.o" 
structure similar to that produced by the C compiler. 
sactionss 


use two 


has three 


input 


called 


The Sample Input Files 


"code", 


usage of 


the 


"date", 


and “file2.o” 


giaiok 


and 


MLINK 


utility 


will 
with a 


Zach 


"bss". 


("bss" stands tor "Block Started by Symbol", and is used for 
data that is cleared to zero when the program 


uninitialized 
is started.) 


In additions we will assume that "filet.o” 
called "rom" containing read-only data, that "file2.o" 
programs 


tion 


has an additional section called "stack" 


stacks and 


that 
(Common synbols are external symbols which are allocated 


both 


files 


for 


contains 


the 


secm 


contain some common Symbols. 


in 


@ 8SS section if no corresponding global symbol is defined. 
They are used by C for uninitialized variables.) 


The sections of the sample input files are 
form (rerepared by gdymp), and graphically in Figure 


tabular 
5-1 e 


filet: 
SECN LOCATION 


filed: 
SECN LCCATION 
0 


1 
2 
3 


--SIlE-- 
00000242 
c0000231 
00000232 
coooczoc 


--SIZE-- 
COCG0242 
00000234 
c0000200 
c0002c00 


shown 


~-ALIGN- -~PAGE""- NAMESATTS 


00000002 
00000002 
cocoo00se 
00000002 


~-ALIGN~ 
OdCdCOCe 
Q0000002 
eteierelelezer 
OCodo0cdG2 


--PAGE-- 


code:X 
romsR 
data: 
bss:BCw 


NAMESATTS 
code:X 
datas 
bss: 3Cw 
stack: 3aP 
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filet.o: 
Reem ewe ween mem ewe we weeny 


| filel.oscode:X | 


¢oaeee <> ae ee mh OP ee Oe oe oe oe a ee oe oe oe 


| filel.osrom:R 


¢ wer wowoe we we we we weeeae wes + 


| filel.orsdatasw | 


owen eewea we wren w woe ewoecoeaon + 


| filel.osbss2w3c | 


ewww ee eowewewwaeewe = ee ee ee * 


file2.o: 


j file2.cscode:X | 
+>w eee naerae ee ee ee ee ee ee + 


| filaZ2.os,dataiw | 


-omweew we we we ewowoew wwe eae} 


j file2.o,vbss:W8C | 


pPwrwseweewewoowaa wre noweessoas > 


{ file2.orstack:wBP | 


<< ernm@eeene HOSA OePR awe aae & 


Figure 5-1. Example Input Files 


§$e4-2- Oofault Section Ordering 


The simplest thing to do with our two sample files is to let 
the linker select sections in their default orderings and 


locate them consecutively starting at zero. The linker’s 
defaults are designed to “do the right thing" for C compiler 
output running in €@n environment like UNIX. Thuss code 


(sections marked executable with the "X" attribute) is 
placed starting at address zeros followed by read-only data 
C"R” attribute), read-write initialized data ("h" attri- 
puted, 3SS C("W" and "8" attrabutesds and stack (*W", "B", 
“p™ attributes). The comnand for doing this is 


mlink -i filet.o fileZ2.o ~o ex! 


where ext is the name of the file which will receive the 
linker’s output. Note that the 4 option flag is not 
requireds since it comes at the beginning of the commands 
ana that if the co linked.out option is omitted the output 
file will be called "“m.lnk". 


The resulting file’s structure is shown below and in Figure 
5-26 


Note that tha tuo 8S8S sactions have been combined sutomati-~ 


cally,- because they have the "C" attribute. Sections with 
this attribute @re automatically combined if their names and 
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other attributes are the same. Aliso note that the section 
“Cconmon™ has been created to hold the common symbols- and 
that the linker has filled in the default section attributes 
"Ww" ("uritable"), "N" C“now"s the inverse of "P") and "*S" 
C"“separate™,» the inverse of "C") wherever appropriate. 
Since the linker has given each section a locations they 
have also acquired the "A" (“absolute”) attribute as wall. 


mlink wi filet.o file2.o ~o axl ~v 
mlink ve 2e1 7" Zilog MUFOM linking utility 
MAPs ISecn CSeen Location Size IFilesName:Atts 


Output file exit: 
O L=GGGO0000 S$=00000242 filet.os,code:ANSX 

1 L=00000242 S=OG0000242 file2.oscode:ANSX 

2 200000484 §$200000231 filet.osrom:ANRS 

3 L=000006b6 S$=O0000232 filetl.osdatasANSwW 

4 £=000008e8 S$=009000234 file2.o,data:ANSw 

§ r=00000b1c S$=G0000032 «-Ccommoan: ABNSW 

6 £200000b4e $=09090400 -bss:ABCNW 

7 L=0CO00T4e S=00002000 file2.osstacksABPSw 


Wii-s#n-oO0o 


Input files: 

&£=00090990 §=00000242 filet.oscodesANSX 
L=00000484 $=C0000231 filet.ovsromsANRS 
L2=000006b6 S$=C0000232 filet.os data: ANSw 
L=CO00Gb4e S=G00CO2CO filetl.osbsssABCNW 
L=00000242 S=O00000242 file2.oscode:ANSx 
L=CO0008eS $=00000234 filed.zosdatasANSw 
L=OC0CCOd4e S=CCO002ZCO Filedc.osbss: ABCNW 
L=QQ0000f4e S=sCO002CCO file2.osstack:ABPSw 


WM 32 OWN @~ © 
NO @ OWN 
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file ext: 


gk eowwewwoewowwoeeraeoc= aeewona 


| filet.o,code:X | 


¢ ece2eeerece Que ewoowaneoewmwaee + 


| file2.or,code:X | 


-oeeeeovrceaes cere wowoworan + 


| filel.osromse i 


¢ ewer oeeoeeoercowoaenwowoe 4 


| filal.osdatasw | 
poems eweeetwewev eve wawewowoawe + 
| file2.os,datarw ] 
Pewee o er wees ere renee e= + 
{| Ccommon: WB | 
ee ee er re re 
| bss:w3C. | 
| filel.osbss:wB8C | 
| file2.osbssewac | 
Goaeweweeeve Fee w ew ewe woeaeos wo > 
| file2.orestacksWBP | 


keae2ee me 288 @ OE Geeaeseas @& @oq aw 


Figure 5-2. Default Selection Ordering 


The sv command-line option of plink was used to generate the 
link map aboves note that its format is slightly different 


from the information displayed by gduyunpe.- More information 
about what glink is doing can be displayed with the v3 


options as shown below: 
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“i filei.o file2.o ~o ext -v3 


MLINK 


mlirk ve 261 =~ Zilog MUFOM linking utility 
“tilei.o’ 


Input file 
0 
1 
2 
3 
Input file 
8) 
1 
é 
3 
Select :X 
0 
C 
Select 3k 
4 
Select :-B 
2 
4 
Select 
3 
MAPs ISecn 


Output file ex 


wWwiian32O0 


R=00C00000 
R=00000000 
R=COCCGOO0 
R=00000000 


“file2.o’ 


OSecn 


1: 
0 
1 
2 
S 
4 
5 
6 
7 


Input files: 


Output file 


WM —§ © UW nw = © 


NO f= OWN O 


*e@xi 


R=000C0C00 
R=00000090 
R=C0C00200 
k=CCOCOCOO 


R=COC00000 
R=00000000 


R=000CO0000 


R=Q00CO0COO0C 
R=00000006 


kR=00000000 
R=00000000 


Location 


L=900000000 
£=09000242 
1200600484 
1=000006b6 
i1=C00008e8& 

=0O0000b1¢c 
L=00000b4e 
L=CO000T4e 


L=0000C0006 

200090484 
L=000006bé6 
L=CV000b4e 
t1=€0000242 
L=000CO8e8 
L=09000d4e 
r=CC0cotée 


¢ 


-- Input file °filet.o’ 


-- Input file 


Zilog Cbhject File Utilities 


“file2.0’ 


$=Q0000242 
$=00000231 
$=00000232 
$=00000200 


$=00000242 
$=00000234 
$=0C000206 
$=00C02C006 


$=00000242 
$=00000242 


$=CC000231 


$2=00000232 
$=00C000234 


$=COC004C0 
$=CC002000 


Size 


$2=00000242 
$=90000242 
$=00000231 
$=9Q0000232 
$=00C00234 
$=CO0000C32 
$=00000400 
$=000026000 


$=00000242 
$=00000231 
$=00000232 
$=00000200 
S=COCOO242 
S=00000234 
$=00000200 
$=caco200c 


filetl.oscode:Nsx 
filel.osrom:NRS 

filet.osdata:NSw 
filet.osbss:8CNW 


file2.or/code:NSX 
filez2.ors,data:NsSw 
file2.o-,bss38CNw 
file2.o/stack:3PSW 


filet.ovscode:NSX 
file2.or/code:sNSX 


filetl.osrom:NRS 


fileleos,data:NnsSw 
file2.or,data:NSwW 


sbss:8CNW 
filez.orestack:38PSW 


IFiles Names Atts 


filet.oscode:ANSxX 
fileZ2.oscode:zANSxX 
filel.eosromsANR§S 
filet.ov,data:ANSw 
file2.orsdat2:ANSw 
eCcommon:ABNSW 
eoss:ABCNW 
file2.orsstack:ABPSW 


filel.o7codesANSX 
filel.eosromsANRS 
filet.osdata:zANSW 
filet.osbss:ASCNK 
file2.occodesANSx 
file2.o,datasANSw 
file2z.osbsssABCNW 
file2.osstack:ABPSw 
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Se4e50 


Sometimes it is necessary to put the sections of the 
than mliok’s default ordering. 
(This is usually done in order to specify the 
the sectionss as we will see in later exampless but is also 
useful for constructing large tables from 
Sections can be selected according to 
their names their attributes, or their file of 


file in some 


different 


order 


modules.) 


Chapter 5 


any combination of these. 


The first example in this series 
Since the 


NARe sz 
simpler. 
come first, 


an their usual order. 


ing map are shown 


command 


below. 


other 


line 
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will 


MLINK 


addresses 
data in 


origins 


salect sections 


for doing this is somewhat 
For examples suppose you want the data sections to 
followed by ROMs and then coda, 
The command for this and the 


mlink “i filet.o filaz.eo -~s data rom -o ex2d -v 


milink ve 21 == Zilog MUFOM Linking utility 


MAP: I3secn OSecn 
Output file exe: 
2 0 
1 1 
1 2 
0 3 
0 4 
= 5 
= 6 
3 7 
Input files: 
0 3 
1 2 
2 ) 
3 6 
9 4 
1 1 
2 6 
3 rd 


Sa 


Location 


L=COCOC00O 
L=CCO00232 
L=00000466 
L=G00C0698 
L=O0CCCOSda 
L=00000b1c 
L=0CC0U0b4e 
L=0000CTf4e 


L=Q00000698 
L=C0000466 
£=G0000000 
L=CO00Cb4e 
L=000008da 
L=COCOC232 
L=COCOCd4e 
L=u00C0T4e 


Size 


$=00000232 
$=00000234 
$=90000231 
$=00000242 
$=00000242 
$=60009032 
$=00000400 
$=C0002000 


S=CCO00242 
$=CG000231 
S$=G0000¢32 
S=O0C0002CC 
$=90000242 
$=CCCO0234 
$=COCO02T0 
$=00002000 


IFile,Name:Atts 


filet.osdata:ANSw 
filez2.ors, data: ANSW 
filel.osrom:ANRS 
filel.o,code:ANSX 
file2.or,code:ANSX 
sCcommonsA&NSwW 
vbss:ABCNW 


file2eosstack:ABPSw 


filel.oscode:ANSx 
filet.osrom:ANRS 
filel.orvdata:ANSw 
filel.orsbss: ABCNW 
file2.or,code:ANSxX 
file2.osdatasANSw 
file2.orsbss:ABCNW 


file2.orstack:ABPSw 


aA9 Zilog Object File Utilities 


output 


several 


8S$Ss anc stack 
result- 
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file exd2: 


& ewe anBWevweawqe eazeaaannasecas @ -— & 


| filel.ovsdatasw | 


pre ewevs een ewe weowamsanae +} 


| file2.o-data:w } 


Fees wreowwewaortowo sre weawawe > 


] frleteosromsR | 


pee ewe ee2ewe we we we eroecaewoe + 


| filel.os,code:X j 


Gewese seo ewes wwecowene asaenwe > 
j fiala2.orcoda:X { 
$wreewwweeowroewe rT ee oe eS + 
| CcommonswB i 


¢ wrewreewvesewewoeae eevee eeaan ww > 


J} oss:Wac | 
{ filet.osbssiw3l | 
i filez.orbss:W3aCc j 
$m oe eee ne eee nee + 
| file2.orstack:wBP | 


FOR OH OBST TFZSS* GC ASTBelee wey 


Figure 5-3. Selecting Sections by Name 


50404-e Selecting Sections by File 


Selecting sections according to their file of origin is 
equally simple. The syntax for a filename selector is the 
filename followed by a commas as in the following example 
where we select all the sections in “filal.o”" followed by 
all the sections in “file2.o". 


Zilos Object File Utilities §-2C 


MLINK 


mlink -i filet.o file2.o -s fileleos file2.o- 


mlink ve 2.1 


MAP: 


Cutput file ex3: 


9 
1 2 


tititiweronw 


Input files: 


WM 2 Ow A) 3) © 


file 


Figure 5-4. 


ISecn CSecn 


0 


NO UN & WA a 


aN & GW “NA 2 
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Location 


L=00000000 
L=CCG0C0242 
L=ctCC0G474 
L=009006a6 
L=COCO032E 
L=GCOCObic 
L=O00002b1c 
L=COCO2bée 


L=00009000 
L=COC00242 
L=000C0474 
L=CO002b49 
L=G0C006a6 
L=Q000008e8& 
L=COCO2d4e 
L=CO000bic 


MLINK 


=o @ex3 Vv 


-- Ziloy MUFOM linking utility 


Size IFilesNamezAtts 


filet.o-,coae:ANSX 
filet.orvram:ANRS 
filel.orsdatazANSh 
file2.or,coue:ANSX 
file2.o,datasANSW 
filec.orsstack:A8PSw 
eCcoommon: ASNSW 
sbss: ABCNW 


$=00000242 
5=C0600231 
S=COCOC232 
$=00000242 
$=C0C00234 
$=CC002CC0C 
$=00000032 
$=6C0004C0 


fileleorcode:ANSxX 
fileteorsromsANRS 
filel.osdata:ANSW 
fileteorbsssABCNW 
file2.ortode:ANSXx 
file2.ordatasANSw 
filez2eorsbss sABCNW 
fileZ2eosestack:ASPSwW 


$=00000242 
$=C000G<231 
$=00000232 
$=00000200 
$=CCO000242 
$=00000234 
$=CG0C0200 
$=00002C006 


| filel.ovcode: x | 
-eewewwewese@t ee wan enemas —_~ a an an aD + 
j filel.ov-rom:R | 
ew ewe ewe wwene owe e a we we oe + 
}  filet.osdatasw i 


| file2.o-datazw | 
$ oer er erer=-=  eetetiethetettettes + 


; file2.orsstask:wBP | 


{| bss: W38C | 
{ filal.osbhbssswaC | 
j fale2.orbsss walt i 


Selecting Sections by File 


Notes, howevers that the combined 8SS section and the Cecommon 


section still come at the end of this Link. 


This is because 
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MLINK 


the 8SS8 sections are combined automatically and the 
is generated automaticallys automatically~-gaenerated 


section 


Chapter § 


sections do not have a file of origin. 


“stack” section is selected along with the rest of file2.o’s 


sectionss which may not be desirable. 


MLINK 


Alsos note that 


You can make sure thet the stack is postponed until the 


of the link in one of two ways: 
ing filename and attribute selections or yun-select 
Commands using these two techriguss are 


the =u 
shown below: 


argument. 


not selecting it by combin- 
with 


it 


mlink ~i filetl.o file2.o “s filet.os file2Zeor7:7? ~0o @x3 


mlink -i filet.o filez.o -s filetl.or file2.o-, 


SeheSe 


In order to circumvent these effectss if 
“ftilet.o” 
Note that in this case you can use 
everything 
"“sostpone”™ sections. The second -s selects all of 
except 


select the 
*"file2.0"%. 
arguments to 
sections 

attribute. 


sections 


select 


Separate -i Arguments 


"stack", 


from 


which 
Also note the use of =-d 


in 


has 
to 


desireds 
bafore 


you 


YOu 


-$ with 


the input list axcept 
file2.o’s 
C"postpone”) 
separate 


thea wpe 
define a 


Ccommon section for file1’s common symbols. 


mlink i filet.eo0 -s “d 71 file2eo0 ~S ~0 ax4 mV 


MAP: 


Cutput file ex4: 


0 


Win=-—O tt Ww- 


Input files: 


nn = © wn ~~ © 


ISecn OSecn 


OMNI UW & GV Ww =| © 


ONO UW Wh) = © 


Location 


L=900C0000 
L=COCOC242 
L=CO0C0474 
L=090006a6 
L=C0C008a6 
L=000008ba 
L=C000Cafc 
L=00000d30 
L=Q0000f30 
L=CO000T4S4 


L=00999090 
L=00000242 
L=00009474 
L=00CO0G6a6é 
L=COGOG38hba 
L=Q0000afe 
L=COCCGd30 
L=CCCOCT4S4 


Zilog Object 


Size 


$=G0000242 
$=CQ00C2¢31 
S$=00000232 
$=00090200 
$=CGC00014 
$=00000¢42 
$=000002¢34 
S=0000C0200 
$=C0900014 
$=00002000 


S$=00900242 
$=C0000231 
$=CG000232 
$=COC00200 
S=CCOO0242 
$=00000234 
$=00600200 
$=COO002C06 


File 


Utilities 


IFile,-Name:sAtts 


filet.orcode:ANSX 
filel.osromsANRS§ 
filel.ordatazANSw 
filel.orsbss:ARCNW 
sCcommon: ABNSW 

file2.orcode:ANSX 
filezceoedata:ANSW 
file2.orbnsssA3CNW 
sCcommonsAsBNSw 


fileZ.osstack:ABPS 


filet.orcoca:ANsSx 
filet.o-rom:ANRS 

filet.o-data:ANSwW 
filet.o-bss:ABCNW 
file2.orscode:ANSX 
file2.ordatazANSw 
filez.orsess:ABCNW 


file2zeorestack:A3PSh 


Ccommon 


“u stack 7o @ex3 


dogut 
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file ex4s: 


keen een= acta ietete etait! wm 
| filel.o-code:X | 
ewer wmerenwerewee we wrwwreeweee we + 
{ filel.orsrom:R | 
eww woewewwroeranerawaecewaoven } 
{ filet.ov,data:n | 
$eeeeme emer ow ese reece owen} 
j filat.os, bsssw3l | 
$emew re weer eres we eo eo ent} 
{| Ccommon:w3 | 
> waewevee eeee ween wceowoe wows} 
| file2.orcode:X | 
¢ eee ewer eeeeeeeeoeowowoewoeen >} 
| file2.orsdata:w ] 
$e mee wm en ee ee eee nen e+ 
|} Ccoommon:sw3 j 
$row ee ee ewww ee ee ne= ~~ + 
| fileZ.or-bsssweac | 
$$ we eee ewww ew ns ewe wwe ew on + 
j file2.or/stack:w3P | 


ger ecewoewoa= Oana @ O22 22 @ ww @@ ® 


Figure 5-5. Separata ~i Argumants 


50406. Selecting Sections by Attribute 


It is frequently more convenient to select sections by their 
attributes than by their names or files of origin. In other 
cases it may be gesessacy- as when preparing s general- 
purpose command procedure in which the nanas of the input 
files might not be known. (For example, the linker’s 
default selection is done by attribute.) 


Section attributes can be combined for selection in several 
different ways. You may want to select all sections that 
have & given sat of attributes, all sections that do gg 
have a particular attribute, or e21ll sections that have 
sitherc of two or more attributes or combinetzans of attri- 
butes. Loosely speakings "not" is rapresented by preceding 
an attribute by a “-" signs and "either" Clogical "“or") is 
represented by separating two groups of attributes by a "+" 
sign. The attributes thamselves are rapresented by upper- 
case or lowercase letters (See Section A.c for specific 
information about the attributes and their meanings). 
Attributes in a selection are preceded by a colon ("3"), 
uhich also separates them from the section names if any. 


For examples you might want to put writable but non-BSS data 


first, followed by read-only datas then coders then 38SS anda 
stacke The command to do this is shown bhelow. Note that 
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MLINK 


the 3SS and stack are 
need not be mentioned 


Chapter 5 MLINK 


selected zt the end by defaults and so 
explicitly. Note that if you did not 


care what order the “rom” and “sode”" sections came ins you 
could have raplaced "sR :X" with either “zRtxX" or "s-w", 
mlink ~i filet.o filez.o0 -s :W-B :R 2X “0 ex5 “Vv 
MAPs ISecn CSecn Location Size TFile,Name:Atts 
Output file exS: 

2 O 1.=00000000 S=CO000222 fileteosdatasANSW 

1 1 L=GCOCO232 S$z=00000234 file2.o,date: ANSW 

1 e L2=C0C600456 S$=00000231 filet.eosromsANRS — 

0 3 L=CO0CCO698 S$=00000242 filet.oscode:ANSX 

0 4 L=00C9C8da S=O0000C242 fileZ.oscodasANSX 

= § L2=o0000b1c S=0CCO0032 -Ccommon:ABNSW 

- 6 L=C0000b4e $=060004900 s-bss:A8CNW 

3 ? L=CO000f4e S=CCCO20CC file2.o,stack:zABPSw 

Input files: 

0 3 t£=00000698 S=CO000242 filet.osvcoda:ANSX 

1 2 L=00000466 S=C000G231 filet.eosram:ANRS 

2 O L=00090000 S=C0900232 filet.ovsdatesANSW 

3 6 L=CCCOGb4e S=CO00CZ0C filet.ovsbss:ASCNW 

0 4 L=000908da S=C0000242 file2.eorcode:ANSx 

4 1 L=COCOC23e S=CO00O0GZ34 file2.ovdata:ANSw 

2 6 L=CCO0CGdse S$=C0000200 file2.o-,bss:ABCNW 

3 7 L200000F4e $=C60002000 Ffila2.osstack:ABPSw 

fila oex5: 

ee ee re de 


filel.ovsdata:w 
$ wewewace 22 SO Or Oe OF 88 OD OF OF 0 a oD a oe > 


filez.osdatasiw 


$ eww mw nn enn en nnn on ee + 
j file2.os,code:Xx j 
> wwe at ececenrawow awww awaeawwa > 
} Ccommon:h3 | 
$ owe we wwe ene wo ee ee ee ee ee + 
i bss:WS8C { 
>} wewwoecne Sy OD ae me DO ee DD OD DD ee + 
{ filez.o,vstack:wBP | 
Pee se 


Figure 5-6. 
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Se4e7- Locating Sections at Specific Addresses 
A common problem that occurs in cross-software development 


is when the target system has both PRCM and RAM, and it is 
necessary to out the program in PROM and the data in RAM, 
The eaddress option specifies the basa address of the naxt 
section to be selected,r so it is used in conjunction with 
selection to control the addresses of sections. 


Another thing most users want to do is to locate the stack 
as high in memory as possibles this can be done with the -t 
address option to specify the to9 address of the last secn- 
tion to be selected. Tha exemple below shows both of these 
section-mlocating techniques. (Note that we are grouping 
some "writable" cata with "read-only" data and code in what 
is presumably the PROM areas this is a common technique in 
languages like C which allow no distinction between writable 
and read-only deta. In such casess tables and $0 on that 
meed to be in PROM are grouped into a single files such as 
filet.o in this example.) 


CIn the example bpelows the command follows the UNIX* conven- 
tion in which a backslash (\) character is used to continua 
a long command on another line.) 


mlink -i filet.o file2z.0 7G ~s :X :R filet.osdata \ 
“4000 -s sW-P -d -s 3P -t CFFFF -o ex6 -v 


MAP: ISecn OSecn Location Size IFilesNamesAtts 


Output file exé: 


wt 


Input files: 


WwWii=-s'(n —Ooo 


WAL © Ul fh =O 


NSO VES WM = © 


NS Oe & Ww 


L=CO0CO0000 
L2=00000242 
L=COCO0434 
L=CO00CO6b6 
£2=00004000 
L=C0C04400 
L=C00C45634 

=0000dffe 


L=0CCCOCO0 
L=00009484 
L=COCO06bé6 
L=COCC4E00 
L=00000242 
=C0004400 
£=000042)0 
L=COCUdf fe 


Zilog Chject 


$=COC00242 
$=00009242 
$=00000231 
$=CQ000232 
$=00900400 
$=0000G<e34 
$=COQ000C32 
$=00002000 


$=C0000242 
$=u9000Z¢31 
$=00000232 
$=C€CCO00200 
$=C0000c42 
S$=CO0000234 
$=00009209 
$=CCOO020C0 


filel.oscodesANSX 
file2eoscodesANSX 
filel.osrom:ANRS 
filel.os-data:ANSw 
bss: ABCNW 
file2.osdata:ANSk 
wCcommon:sABNSW 


filezg.osestack:AaPSw 


filet.oscode:ANSX 
filel.osromsANRS 

filel.osdata:ANSh 
filet.osbss: ABCNW 
file2.oscode:ANSX 
file2z.oredatas ANSW 
file2.o-bss:ABCNW 


file2.orsstack:ABPSw 


File Utilities 
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J filet.orcode:X | 


pwowwewvoeneecaewoerecoooe eeoeanae > 


| file2.oscodesX | 


fpoeweezeenrnawoecoewvewooe aoe e ae > 


| filel.osrom:R  f 


$oerereneece eweewecoeorens+ 
{ filel.osdata:h | 
¢eeee cron owe ee wee mew een + 
4000 poem wenn n-ne en ennn-- ----+ 
| bssswB8Cc i 
$oeeoee wee eee ee meme en e= + 
| file2.osdata:y } 
¢oooee wee eer eneeee tte teetet 2 
{ Ccommon:W8 | 
-ewerweawzaeraeeavannocerevceeco=] + 
DFFE ¢eecerocerceo correo taal 2 
; file2.osstack:wBP | 
FFFF kee weoeewoonmre-— weeror owen 


Figure 5-7. Locating Sections at Specific Addresses 


$24.8. Naming and Combining Sections 


It ts usually not necessary to combine or rename sections in 
order to affect their location or orders but naming and com 
bining can be useful if the output of the linker is a relo- 
catable file which is going to be used as input to a subse-~ 
quent link. For examples, you may want to construct a 
library module containing the code and data from several 
sub-modules. In this case it may be desirable to have only 
2 single combined code sections a singla date sections and 
$0 one An example of this is shown below. Note the use of 
-r to keep the resulting output file ralocatabls. Nota that 
we are specifying attributes as well as section namess and 
that neither the names nor the attributes of the combined 
sections have to be the same as those of the input sactions. 
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mlink wi filet.o file2d.eo -r =s code =n code:X \ 


MAP: 


Output file ex?7: 


-s data -n datazsw “s rom “n romsR -o ex? 


ISecn OSecn 


Witte 


Input files: 


WN? OWN 


file 


Figure 


wi & WA) 2 © 


Ww F&O fF AN OO 


378. 


Location 


R=00000090 
R=O00C00006 
R=COCO000G 
R=C00000)90 
R=CO000000 
R=90000000 


R=00C00000 
R=O00CCO00O0 
R=00000000 
R=00000000 
R=Q0000242 
R=00000232 
R=CG0006200 
R=00009000 


ex7s: 


% eevee e Ree nnn ee ae ae een ae _ ow ae 


codesx 


Size 


$=00000484 
$=00000466 
$=CC000231 
$=00900032 
$=C0000400 
$=00002000 


S=OQ0000242 
$=C0000231 
$=00000232 
§=0000C200 
$=00000242 
S=CC000c34 
$=Coccc200 
$=00902009 


filel.os,code:X 
file2.oscode:X 


romsR 


filel.osromsk 


data:wW 


filel.osdata:w 
file2.o,data:w 


bss :WS8C 


ab Oe ob > GE Ge ab i Gb a ee we a di a i Oe ee oe eS oo 


filel.ososs:WwBaC 
file2.osbss:w8C 


“VW 


IFilesNamesAtts 


ecode:NSXxX 
sdata:NSW 

sromeNRS 
7Ccommon:8NSW 
ebss:8CNw 
file2.or,stack:BPSw 


filel.oscode:NSX 
filet.ovsrom:NRS 
filel.os,data:Nnsw 
filel.osbss:8CNwW 
file2.o/,coae:NSX 
file2.os,data:NSw 
file2.orsbss:BCNwW 
file2.o,stack:8PSw 


Naming and Combining Sections 
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54.9. Overlays 


In small systems it is sometimes necessary to break programs 
up into nieces that “overlay” or load on top of one another. 
A clever loading program that understands about sections 
could select the sections belonging to overlays out of an 
abject file containing the whole orograms but more often it 
is necessary to put overlays in a separate file. This can 
be done in a single Linking step by specifying multiple out>- 
put files. 


A related problem is making sure that the sections that are 
supposed to overlay one snother start at the sane address. 
This can be done easily if we want to specify the address 
exactlys but more often the cverlaid sections are located 
relative to other sectionss whose size we don’t care to keep 
track of. The 7m (mark) option is useful here. 


The techniques used for making overlays are shown below. We 
assume that the code and data in file2.o are needed only 
part of the times and can overlay filel.o’s data sections 
which we therefore locate after the Ccomnon and 3SS secm 
tions. we locate the stack at the high end of memory using 
the =t option. It deesn’t matter which overlay file the 
stack goes with becausers being @ 88S sections no date is 
actually loaded into it. 
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miink wi filet.o file2.0 -s filel.oscode 
-s filelt.eorsdata ~o exé \ 
2P -t CfffF -o ex8s -v 
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Location 


L=COCco00CE 
L=G0CCO242 
L=00000474 
L=CCCO0874 
L=CCCO0Saé 


L=CCCCO&aé 
L=00C0Cae8 


-m1 
“m1 -s :X :w-6 
MAP: ISecn OSecn 
Output file exé: 
0 C 
1 1 
- 2 
= 3 
2 4 
Output file oxSa: 
G 5 
1 6 
3 7 


Input files: 


WN 3 O Why = © 
NNO UPR & 9 © 


L=0000df fe 


L=0CCCOOCO 
L=J9000242 
L=COCOO8aéd 
L=COCOC474 
L=00C008a6 
L=COCO0Cae8 
L=00000674 


L=0000df fe 


Size 


$=CC000242 
S=0C6CC0231 
$=C0000400 
$=CCCCCC3e 
$=COCOC232 


$=00000242 
$=C0000234 
$=09002000 


$=CO000242 
$=C00000231 
$=C0000c32 
$=C0C000200 


$=3I000242 


$=0C00C0234 
$=00009200 
$=0C002000 


MLINK 


sR =s 3:3-P -d \ 


IFile,Name:Atts 


filet.oscoda:ANSX 
filel.ovsrom:ANRS 
rbsssASCNW 
eCoommon: ABNSW 
filel.ov-data:ANSw 


file2.oscode:ANSX 
fileZ.o-data:ANSW 
file2.orsstack:AB8PSW 


filet.oscode:ANSX 
filel.orrom:ANRS 
filel.ovsdata:ANSw 
filet.orbss:ABCNhk 
file2.orscode:ANSX 
filec.oredata:ANSW 
file2.orbss:A8CNW 
file2z.orstack:AB8PSW 
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file oex8: 
Good eR wwreoen swe 2eeeweoevwveF ZZ eA eZee * 


{ filet.osrom:R | 


¢ owen eee weseaewew es eseaensenanse ae +> 


| bsssw3C 


} Ccommon:w8 | 


SO Bee Ban anaaweaae aeweew ae ae + 


| filetwosdata:y | 


te wewewrewrwweavwwewrwoeoaveowaoe * 


Co 


O8A6 


file ex8e: 
0846 gre me wee ewe wwe we ee eee ewe + 


| file2.orcode:X | 


-oewwe wean ewe nea ene eee aus ee + 


{ file2eor/datazw | 
$ wee mewn meme wow een enn e- + 
DFFE towne wenn nen nen n nn n--- + 
| filez.orestacks:wBP | 


Figure 5-9. Overlays 


5.4.10. Discarding Sections 


It is sometimes useful to produce an object file containing 
only some of the sections of the input files. This is an 
alternative way of producing overléeyss it is used more often 
if one input file contains an operating system and another 
an application that runs under it. The application will 
need to know the addresses of routines in the operating sys~ 
tems but can assume that the operating system will already 
be in memory. 


Sections are discarded by giving aA 70 option with no 


filename. This is shown in the example belows in uhich all 
the sections in filel.o ara discarded. 
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Chap 


nlink ~i filel.o -s *d ~o wi 


MAPs: 


eT 


TSecn 


Discerded: 


iW sO 


Output fil 


tA § MO 


Input file 


WN -@ OWN =~ © 


>i 


=31 


CSecn Location 


0 L£=C0000000 
1 L=00000242 
2 L=00000474 
3 L=oC0C006asd 
4 L=0Q0000EaSs 
@ ex9s 
§ L=CCCOC3ba 
6 Lr=J0000afc 
7 &L=00000d30 
& L=000C0Ff30 
Y L=O0T00F44 


Ss: 

0oco000 
JO00242 
0000474 
s0C006a6 
NQ008ba 
GCOVafc 
G0G00d30 
COVD0FT4SS 


Honk tn tw @ ou 
Oanrnnaqn 


WNAUWN =O 
Ser Crees 


ile ex: 


{ file2.o, 
| file2.o, 
| file2.o, 
} Ccommon: WB 
| file2.o, 


Figure 5-10. 


ter 5 


file2.o -s 


Size 


$=C0000 242 
§=00C00C231 
$=G0CI023e 
S=C0000200 
$=00000014 


$=CCO0C242 
$=00000234 
$=COC002CO 
$=000C0014 
$=00002009 


$=COCO0 242 
$=C00900231 
$=00000232 
§=C0C0C2C0 
$=80000242 
$=CCOOC234 
$=0C000200 
$=0900020090 


MLINK 


-~0 @x9 -v 


IFilesName:Atts 


filet.os,code:ANSX 
filel.ovsrom:ANRS 
filet.osdata:ANSw 
filel.osbss:ABCNW 
sCcomnon:ABNSh 


file2.orcode:ANSX 
file2.os,data:ANSw 
file2.osbss:A8CNW 
7eCconnon: ABNSW 


filez.osstack:ABPSw 


filel.os,code:ANSX 
filel.ovsrom:ANRS 

filel.ovs-data:ANSh 
filel.orsbss:A3CNW 
file2.oscode:ANSX 
filez2.osdata:ANSw 
file2.or-bdss:ASBCNW 


file2.os,stack:ABPSW 


Discarding Sections 
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6e1-2 INTRODUCTION 
The mlist utility uses spacial commerts that the assembler 
can optionally insert into an object file (with the ~aesen 
assembler option) to construct an assemnblere-liake listing 
file fron a MUFOM object module. 
6e2- COMMAND SYNTAX AND OPTIONS 
The command syntax for this utility is as follows: 

mlist {€-o file} E-s | -1 | -x] Cfiledj 
The file and options may appear in any order. If no file is 
Jivens standard input is used. 
The command-line options are: 
-o file 


output file mame (If not specifieds output is to stan~ 
dard output.) 


-s short format (**x%s instead of expressions) 
=~] long format (single long line for overflow of otject 
code) 


-x exclude object code thet doesn’t fit on the source 
line. 


623. USAGE» OUTPUT FORMAT AND EXAMPLES 


The input file shoulda be generated by running the assembler 
with the *es ron optionss to get source code and line 
nuabers into the object file. Most object-file utilities 
can be made to preserve comments with the ek options the 
comments used by mhigt are in levels 2 ana 3, so the 7=k3 
option should be used. In particuléers keeping comments 
through mlink means that an assemblervrlike listing can be 
Jenerated from a fully linked and relocated Load nocule. 


A full explanation of the MUFOM variables used in the 
axpressions displayed in the object-code column of the 
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Listing can be found in Appendix Aw The more common expres- 
sions are: 


Xnan external 
Rnnntoffset relocatable in section nan 


Apart from addition, represented by an infix "+" signs 
operations in expressions are listed as 


operation Coperands operandece) 


even for operations 
expression is enclosed 


entire 


parentheses. 


in 


The following examples show 2 short 


gram with 


such as “x" for multiplication. The 


additional set of 


assemblyrlanguage pre- 
its assembier listings and glist-senerated list- 
ings in the various available formats. 


asm&80Qk -oson 0c fo0e8S 7-0 £00.20 ~p 
eem89k varsion 2ela 
Mon Apr 28 09:41:34 1986 foo 
LOC OaJ LINE® --- SOURCE --- 

1 eGxtern xxx 
OC00COSE 612191 8C3cWheswowow 2 ld ris re2CfootiCr3) 
OCUVO0COS 140 2xaexkexnn 3 foots ldl eres #xxx + foot 
COC000Ge 4 eblikb 1000h 
020C0710Ce R000400C00003-*«* 5 edd foots xxx * 100 fool “« 
00901013 cee eeaKaKkenhee 

é 


mlist foo.9 


mlist ve 2.1 => Zilog MUFOM listing utility 

cccccoce 1 ee@extearn xxx 

CGOOCOCH 61274803 (RO+8) 2 id ri, er2Cfooti(r3] 
J0G09008 1402 CX0+R0+E) 3 fool: 1ldl rrise &xxx + fool 
Coogcove 4 eblkb 1000h 

9090190e C€RO#8) €*(X0754)) 5 edd foots xxx * 1C0Gr foot “< 
OCOO1C1e CeINSCG,RO+Es 5s 

CocOIC16 «f)3 
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nmlist foo.eo -s 


mlist ve. 2.1 ~~ Zilog MUFOM listing utility 


ooocooos 4 eextern xxx 

OCOCOCOD 61218C3ckekakeen 2 1d rt, er2lfootil(r3] 
N9G30008 1402xxxaxkwan 3 fool: 1dil rr2e R#xxx + fo01 
GGcoooCcOe 4 ebikb 4000h 

OCCCITICCe exexxkeexekeaakkake 5 edd fools xxx * 100 fool * 
09991016 «xxxkrex%% 

mlist f00.0 ~x 

mlist ve 2.1 -- Zilog MUFOM listing utility 

ocoocsoo 1 eextern xxx 

0390000990 61217803< CRO+8) 2 id rity rer2écCfootjlr3) 
BDOGC00SS 1402 (xX04+RO+8) 3 foot: ldl rrfe #xxx + foot 
oo0ocdde 4 ebikb 4000h 

0000100e (RO+8)C*#(X0,64)) 5 edd fools xxx * 109 foot * 





mlist foo.o ~l 


mlist ve 201 =~ Zilog MUFOM listing utility 


Joo0c0oOT 1 eGxtern xxx 

OCOOCOGIO 61271893 C(CRO+8) e ld ri, rr2Cfootglrz] 
COGCOOCS 1402¢(xC+RO+8) 3 fool: idl reise #xxx + foo 
C0coCOCe 4 eblkb 1000h 

0000700e CROt8)(*#(X0,64)) 5 dd foots xxx * 100+ foot * 


OOGG1016 CSINS(COsRO+8,3-4Ff)) 
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MLCAS 


Tele INTROOUCTION 


The g]eag utility is a format conversion progran which 
translates MUFCM files into one of three fornats suitable 
for moving an object moduie from a host system to a target 
system. The three output formats are Taktronix end Intel Hex 
formatss and a simplified version of MUFOM. milga¢ is usually 
used in conjunction with protocol], which sends the resulting 
outout to a target systam using the Tektronix or other 
handshaking protocol. 


In addition to simply converting formatss yload has several 
options which are useful in burring PROMs and in download- 
ing. 
Velde COMMAND SYNTAX AND OPTIONS 
The command syntax for this utility i¢ as follows: 
mload fCoptions) ifile2 

If no filaname is givens the standard input will be con- 
verted. 
The command-line options are: 
-o file 

Output file name (Cif not specifieds output is to stan- 

dard output). 


“a MUFOM absolute download subset (default) 


=4 This option specifies the output to be in Intal Heax 
formats as defined in Appendix C. 


-t This option specifies the output to be in Tektronix Hex 
formats as defined in Appendix 38. 


(Tne following are useful for burning PRCMs.) 


-N Output avery Nth byte. DJivide input addresses by N to 
get output addresses. 
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ao Start at Cinput) address a. 
=H Output AH bytes. 


(The following options are useful for downloadings and espe- 
cially for mapping code into a specific segnent.) 


+H Add offset of 4 to every gutoyt address. 

“Dp CPROM) Subtract start from every inpyt address (before 
the division specified by -N option). This starts out- 
put addresses at zero for burning a PROM. 

“Zz Map Z3001-type segmented address3s into 24-bit linear 
addresses. The 77-bit segment number in bits 24-30 of 
the input address is placed in bits 16-22 of the output 
address. Thus, the Z800C address 12061234 
C<<12h>51234h in assembler notation) is napped into the 
output address 121234. 


(The following apply only to MUFOM or Intel download for- 
mats.) 


“9 Cutput global symbols. 
-j Output local symbols. 


“k Keep comments of level N or lower (MUFCM only). 
(default: WN = 255) 


=-s§ Cutput section infornation (MUFCM only). 
7e3e OPERATION 


Fedele mload Input 

The input to gload is a single MUFOM format abject module. 
If the input object module is relocatable ( j.g./ there ara 
symbols for address references for which no values have been 
associated), then glgad wili produce an error message but 
will proceed with the translations relocating every section 
starting at zero. 

Tese2e miocad Address Translation 

The parameters that effect gload’s address translation are: 


S the specifieo starting address (&S option). 
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L The number of bytes to be output (C=L option). 

T the specified offset (+T option). The ~p option sets T 
= -$. 

N the number of separata PROMS being burned (-N option). 


Given an input address As this will be translated to an out- 
put address A/N - 7. Cnly data with eddresses between S and 
S + N*L will be loaded. 


Vedsede Output Format Liaitations 


It should be noted that all symbolic information is lost 
when MUFOM is translated into Intel or Tektronix Hex. In 
additions MUFOM sections have no counterpart in Intel or 
Tektronix formats ic@er all sections in the MUFOM file will 
become one contiguous set of records when translated. 


Intel Hex format limits addresses to 16 bits without 
extended addressings and 20 bits with extended addressing. 


Tektronix Hex format limits addresses to 16 bits. Thus, 
large programs may have to be downloaded in several pieces. 


@e4e USING mload: SOME EXAMPLES 


The following examples show how gioad works. The first few 
examples assume the following input module called “tload.o”: 
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VeSete 


Chapter 7 


MBZ8OK-OStload. 

AD03/C4rM, 

9719860505094554. 

COG1COs,15--- Section Table ---. 
STO00/48,03abs. 

SACO,C2. 

ASS0C-0111. 

ASLOG,-OO. 

STC1/A+-XeC4code. 

SACT/O2-~ 
ASSO1-2F0C20CE,2F0020CC.-. 
ASL91-2F0020C0. 

COG1IS1+14--~ Symbol Table ---. 
A3G,2FC020CC. 

NNO1,03f00. 

ASNC1-C1C1. 

NIOO-OSstart. 

ASTO00,2F002C00. 

CO9132618--- Program Sections ~---. 
$BO0. 
LRODOTOZO0S04CSO060708O09TADBOCODCECF. 
ASP90,0101. 
LROTOZ03040STb6C7TO8090AOBOCCOCECFIC. 
$801. 

LRSEC3SAFOCZO0C. 

ME, 


MUFOM Download Formats 


The following three exéemples show the use of gload 


duce 
INGe 
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to prom 


ebsolutea MUFOM output in a form suitable for download=- 
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Command: 
mload tload.o ~o load.o 
Output: loaad.o Cabsolute MUFOM) 


MBZ80K-O05tload. 

ADC8,C4sM. 

ASP00,00. 
LRCOOTGZO3040S5S060708C90ACBCCCOCECF. 
LROTO20304050607C8090A0BCCOOCEOFIC. 
ASP00,2F00Z0C0. 

LRStGC8AFCO2CCC. 

ASGs2FO0C2Z000. 

ME. 


Command: 
mload tload.o 70 load.o ~“§ 
Outputs: load.o CMUFOM with sections) 


MBZEOK,-OStload. 

ADC8sC4/Me 

€09100-15--- Section Table ---. 
STOO,A,-C3abs. 

§A00-02. 

AS$00-0111. 

ASLOG,s 00. 

STC1Is,Ar As OScodee 

$A01-02. 

ASS01-06. 

ASLO1,2F002000. 

C€00101,14~--- Symbol Table ---. 
COO01C2+18--- Program Sections ---. 
$300. 

ASP00-,00. 

LRODOTO203 04605060708 090RC30CCOOSOF. 
ASP00-0101. 

LROTO2Z03 0405060708 D90A0S0CODCEOFIC. 
$BO1. 

ASP00,-2F002900. 

LRSEQSAFCG20C0. 

ASG-2F002000. 

ME. 
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Commands 


Outputs: 


Ve4elte 


mMload tload.o ~o load.o -slg 


MBZ8CKsO05tload. 

ADOE, 040M. 

C00100,15--- Section Table ---. 
STOO,A,/O3abs. 

§$A00,02. 

ASL00,00. 

STO1¢AreAsD4code. 

SA01-02. 

A$3$01 706. 

AS§L01-2F0020C0. 

C00191-14--- Symbol Table ---. 
NNO1,03foo. 

NI00,905start. 

ASTOO,2FCO20CC. 

COO0102s18--- Program Sections --~. 
$800. 

ASP00,00. 
LROOOT020304C5CE07C8O0SO0ACSOCOCOOCEDOF. 
ASP00-0101. 
LRO1G02030405C6G708090A0B0COOOEOFIO. 
$801. 

ASPOO-2F0020C0. 

LRSEQSAFOOZ000. 

ASG/2F002000. 


ME. 


Translating from MUFOM to Intel Hex 


load.o (MUFCM with sections and symbols) 


MLOAD 


Suppose that you want to translate an object module that is 


formatted in  MUFOM into Intel Hex records. 


example shows how this would be performed: 
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Commands 
mload ~i tload.eo ~o load.o 
Output: load.o (Intel Hex) 


mload ve 2e1 “~~ Zilog MUFOM load formatting utility 
s100000CO0001TO2C3040506C7C8S090A0SBCCODOEDF78S 
£10910100010203504050639708990ADB80CODQDEDFINSS 
sO0620000CSEOSAFCOZO00AS 

:00200003D0 

:00000001FF 


The -i option specifies that the input be translated into 
Intel hex records. link.o is the input file. 70 loadeo 
specifies that output goes into the file callad load.o. 


Note that the addresses in the output have been truncated to 
16 bits. 


724.3. Translating from MUFOM to Tektronix Hex 


The method shown for translating object nodules from MUFOM 
format to Intel Hex in the previous section is the same 
method used for translating Tektronix format. instead of 
the i option Coutput = Intelds the ~t option is used to 
indicate that the output will be Tektronix format. 


The following example shows the translation of a file to 
Tektronix Hex with output on Standard Output. 


Command: 
mload ~t tload.o 

Output (Standard Output) 
mload ve 2e1 ~~ Zilog MUFOM load formatting utility 
40G001001000102C3 040SC6C7OSOS0ACBOCOOOCECF783 
40101100301020304050607C8090A0B0COQD0EOFIN79 


/20000608S5E03AFO0 200036 
4290000002 


Nota that the addressas in the output have been truncated toa 
16 bitse 
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7e4e4. Downloading to a PROM Progranner 


Downloading a program or segment theresf to a PRCM program 
mer is straightforuard. First, generate 2 file of the 
proper format, i.e.es Intel or Tektronix Hex. Seconds attach 
the programmer to your terminal’s auxiliary port. Thirds 
cat CUNIX*®) or tyoge (00S) the file while capturing the data 
on the programmer. Lasts burn the PROM, This method has 
been used successfully with Data I/G Programmers and ADM 31 
terminals. 


A second method can be used if tha PROM programmer is 
attached to a second serial port. In this cases tha output 
of mload can be sent to this port instezd of toa file. If 
the PROM programmer requires a handshakes protocol] can be 
used (see Section 10.3.3 in the chapter on arotosol.-) 


724-5. Programming Multiple PROMs 


When a program is too big to fit into a single PROM, it is 
necessary to perform several loads. The following example 
shows how to do this. 


Suppose you have a files “filei” which is to be translated 
into two Tektronix-format files “promi" and “prom2” with 
starting addresses OC0O0 and 71000 Chex) respectively. You 
can do this with the tuo commands 


mload -p filet -o promt 
mload ~p filel -o prom2 a1CC0 


The a1000 option in the second command specifies that output 
starts with adaress 1000 (Chex). The =p option specifies 
that the physical addresses in the output files start with 
0900. 


7e4e6- Programming PROMS for a 16“bit Processor 


when developing software for 16-bit processors such as the 
Z8O0CO- it is necessary to program odd and even locations 
into separate PROMs. The following example shows how to do 
thiss 


Given a file "filet" which you want to separate into two 
Intel-format filess “promd" and “promi” respectivelys you 
use the two commancs: 


mlioad =2 -p fileil -o promd 
mload -2 -p filat -o promt @1 
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The 2 option specifies that two PROMS are being pregrammed,s, 
so that only evary other byte is to ve loaded. The -p 
option specifies that addresses in the PROM output file 
start with O. The @14 option in the second command specifies 
that output to file “promi” starts with adaress 1 in the 
input file. 


Note that for 32-bit processorss 74 can ba usec to produce 
four PRCMSsS. 


Teh4eZe Translating Logical to Physical Addresses 


When cieveloping softuare for systoms that incorporate menory 
mappings it is sometimes necessary to load software et a 
different address (physical address) from the address at 
which it is intended to run (logical addrass). The follow- 
ing example shows how to perform this translation using the 
+toffset option: 


Given a file "filet" containing a program linked starting at 
logical location Qs you want ta load the program into physi- 
cal segment 1 on a 28001. The 28001 Ct places the start of 
segment 14 at O700COCOC hex) the target system’s memory 
places it at O010000Chex). Use the command: 


mload filet -z +010900000 


The output of this command is another MUFOM file on standard 
output. The “Zz option specifies that 32-bit 28001 logical 
addresses are mapped into c4-bit physical addresses by 
"squeezing out” the second byte. The +¢01000000 option 
specifies that 017000000 is added to logical load addresses 
in the input file (beferg tne translation implied by the -z 
option. 


Note that only the addresses at which data are to be loaded 


are mapped. Addresses in the programs and the values of 
symbols, are unchanged. 
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8.1. INTRODUCTION 


The mlorder utility takes a list of MUFOM modules and com- 
putes the optimum order for putting these modules into a 
library. "Optimum order” is the order that allows ail 
required modules to be found in a single pass through the 
library, thus, all modules in the library that reference a 
symbol appear in front of the module that defines it. 


It is not always possible to find such an optimum orders 
miorder will inform you if this is the case, with the mes- 
sage: 


cycle in data: 


followed by 3@ list of the modules that contain a circular 
series of raferences. 


The output file generated by plorcer is in a form that can 
be used by m]ljib to generate a library. 


8.2. COMMAND SYNTAX AND OPTIONS 


The gpilorder conversion utility is invoked by the following 
commands: 


mlorder C-r] Cfilej... 


The command-line options are: 


-r If the -e option is givens the standard output is 4a 
list of pairs of object file namess neaning that the 
first file of the pair refers to external identifiers 
defined in the secona. The output may be processed by 
tsort to find an ordering suitable for ane-pass access 


by link. 


Alternativolys the proper ordering may be generated 
directly by mjorder by not giving the -r option. In 
this casa the output is 2 fila suitable for diract 
input to glib with the f option. 


3-1 Zilog Object File Utilities 


Chapter 9 
MNM 


Gate INTRODUCTION 
The mom utility prints the symbol table name list for a 
given file in any of several formats. 
9e2e COMMAND SYNTAX AND OPTIONS 
The command syntax for this utility is as follows: 
nee Coptions] Cfiles 


If no file is givens standard input is used. 


The comnand-line options are: 
=): Include local symbols in the listing. 
“nn Litt symbols in numerical order. 


“u List symbols unsorteds that iss in the order they 
@ppear in the object file. 


—m List symbols with link map information. 


-s Swapped formats with name first on the line. 

“-s N 
Swapped format with name first end truncated to N chare- 
ecters. 

-o file 
Direct output to the given file instead of standard 
output. 


9e3e OUTPUT FORMAT AND EXAMPLES 


mny displays the synbols defined in the given file in any of 
several formats. Options are provided to display 
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° only global and external symbols (the default) or local 
symbols as well. 


° symbols in alphabetical orders in numerical order by 
addresss or in their order of definition. 


° with or without Link map infornatione 


° in a short form suitable for use with symbolic 
debuggerss emulatorss or other utilities. 


9e3e1- Default Name List Format 


The default format of the symbol name list is shown in the 
example below. The list has a line entry for each symbol. 
The first column shows the value of the symbol. This is a 
hexadecimal nusber for absolute symbolss or an expression 
involving an R-variable (relocatable section origin) or X= 
variable Cexternal symbol). More complex expressions are 
listed as “<expression.>". 


The second column contains "X" for external syabols, "I" for 
global Cinternal) symbolss and "N" for local symbois. 


The third column contains the name of the symbol. 


mm -l1 fo00.0 


mmm Ve 2et =~ Zilog MUFOM namelist utility 


00001002+x0000 N expr 
<Expression.> N expre 
cocodooc+xo0co X ext 
00000000+x00C4 X ext2 
00000004+R00CO I glb1 
00001002 I gib2 
000001234S56789abcdef I glb3 
00000005+¢+RCO0C0 N loc 
0000000a+R0000 N loc2 


Note that the above example was prepared with the "= ]" 
option to list local symbols. 


9.3.2. Name List with Map Information 


The ~m option can be used to list symbols with information 
derived from the section tables and from the link nap in 
modules output by plink. The fourth column contains the 
file of origin for the symbols with a library name in 
parentheses if the symbol came from a library. The fifth 
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column contains the name of the sectisn in which tha symbol 
resides, and its attributes. This column contains "2:" if 

the section cannot be determined. (The spece between 

columns has been decreased a little in the example balow to 

make it fit within the margins in this nanual.) 

mom “m f00.0 

mnam ve 2e1 ** Zilog MUFOM namelist utility 

COC05774 I _ align doprtz.oCfoo.elibds Llibcode:ANS) 
00005256 I -.doprtz doprtz.o(foo.lib), lLibcode:ANS) 
90905086 I __iob strlen.oCfooelib)s, libcode:AKS) 
00005786 I __prtint doprtz.o(foo.lib)ds libcode:ANS) 
O90058b2 I __xpute doprtz.oCfoo.lib)s libcode: ANS) 
099095900 I _atoi atoi.o(foo.elib)ds lLibcode:ANSX 
00005200 I _printf printz.eoCfoo.e.lib)s libcode:ANS? 
000000Ca I pute foo.o7 alifao:ANSw 

OO0005Eefa I _strlen strien.oCfoo.lib), libcode:ANS) 
00005026 I .strnemp strncemp.oCfoo.lib)ds Libcode:AN§s 
00000000 I fool fo00.0/ allfoo:ANSw 

009000002 I food foo0.e0r7 allfoo: ANS 

oooccca4 I foo3 foo.0r allfoosANSw 

000067 ab I gru strlen.oC€foo.lib)s, ?: 

60004567 I zoo strlen.olCfoo.libds ?: 

00C05026 I zorch Strlen.o(foo.lib),s Llibcode:ANS$) 
00001234 I zork strien.o(foo.lib)s 7: 

00001234 I zorn Strlien.o(foo.libds 73 

00005678 I zot strlen.oCfoo.libds, libcode:ANS) 
923-3. Swapped Name List Format 


In order to interface to some symbolic debuggerss it is pos- 


sible to get a “swapped” listing with tne nama first on the 
line. It is also possible to truncate the name field to a 
given number of characters. This is done with the -s or ~s 


N options as in the example below. 


manm ~s8& f90.0 


mom Ve 2e1 ~~ Zilog MUFCM namelist utility 


exti Xx 00000000+x0900 

ext x 00000000+x0001 

glb1 I 00C00004+R000C 

glb2 I 00601062 

glb3 I 0000612345678Sabcdef 
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10.1. INTRODUCTION 


The gorotose] utility is the upload/download communication 
handshake program. It sunports a variety of different 
file~transfer protocols commonly used on PROM programmers 
and development systems. It is normally used in conjunction 
with mload to download modules into a target system. 


10.2. COMMAND SYNTAX AND OPTIONS 
The command syntax for this utility is as follows: 


protocol Coptionsi] tfileJ 


A maximum of one file may be specifieds if no file is speci- 
fied the standard input is used for downloadings standard 
output for uploading. Order of command line arguments is 
not significant. 


The command-line options are: 


-d device 
download device name. (If no -d option is given or no 
device is specifieds the terminal is used.) 


-u CdevicelJ 
upload device name. (If no device is specified, the 
terminal is used.) 


-f file 
take command arguments from the specified file. Argu- 
ments in the file may be separated by whitespace or 
newliness comments start with a semicolon and end with 
newline. 


-@ 
Suppress error messagese. 


-s string 


setup string sent to upload/download device. Multiple 
“gs options are permitteds the strings are concatenzcted. 
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-p protocol 
specifies protocol. (Default Tektronix.) 


The protocol is matched with a list of protocol names. 
Case is ignoreads and abbreviation is allowed. 
Presentlys the only protocol defined is "Tektronix". 


Protocol may also be a list of itens of the form 
"“variable=value". Values are numerics hex if they start 
with "O", cdecimal otherwise. Variables are one of the 
followings: 


ack 
acknowledgement character. 





nek 
negative acknowledgement character. 
abort 
ebort character. 
linedelay 
delay Cin milliseconds) after sending each line. 
chardelay 
delay (in milliseconds) after sending each charac- 
tere 
prompt 
prompt character. 
retry 
number of times to retry an incorrectly-received 
record. 
timeout 


timeout in seconds. 


10.3. USING protocol: SOME EXAMPLES 


10.3.1. Downloading to a Z8 or 28000 Development Module 
To download an object module to a target systen such as a 
Zilog 28 or 28000 development modules the following pro- 
cedure is used: 
(1) In Unixs create an alias with the command 

alias LOAD ‘protocol -t’ 


In other operating systenss creaete a command file with 
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the same effect. Note that the filename argument to 
the LOAD commana is appended after the "“t" option. If 
you want to specify MUFOM object modules rather than 
Tektronix hex, your alias or command file will need to 
run them through gloag firsts this can ba done with 
@lias LCAD “’mioad -t * | protocol -t’ 

(On operating systems other than Unixs this will take 
two commands, with gload creating & temporary inter- 
mediate file.) 


C2) While running in the development module’s monitors exe- 
cute the commands 


LOAD <filename> 


The development module sends the host the command: 

LOAG <filename> 
which the host interprets as 

protocol -t filename 
which performs the Tektronix handshake protocol with the 
development module. 
10.362. Uploading froa a Z8 or 28000 Development Module 
The procedure to upload from the Z8 or  Z800C development 
module is slightly more complicated than the procedure used 
to download. Tre user must know the starting and ending 
addresses of the image to be uploaded before proceding. 
siven thats the following procedure must be followed: 


C1) Alias “SEND” to “protocol -u -t",. 


(2) While running in the development module’s monitors exe> 
cute the commands: 


SEND <filename> <starteraddr> <end-adar> 


The development module sends the host the conmand: 
LOAD <filename> 
which the host interprets as 


protocol eu -t filename 
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This invokes protocol, which performs the Tektronix 
handshake protocol with the development module. The result- 
ing file is in Tektronix Hex formats suitable for download- 
ing again. 


NOTE that “protocol -t cru filename” is incorrect: this 
causes orotoco) to interpret the given filename as the dev- 
ice to upload froms with odd results. 


10.3.3. Downloading to a PROM Programmer 


Some PROM programmers do not require a download protdcols 
they simply have a file copied directly to thems as 
described in the chapter on gload. Others (Ce.gese the 
DATA/IO model 27) require more elaborate treatment as 
described below. 


It is most convenients if a device requires a complex douwn- 
load. protocols to make a command file. For downloading to a 
OATA/IO model 29 attached to device “/dev/tty4", this file 
(call it "dataio”") should contain: 


-d /dev/ftty4 
-s \C\C86A\rI\r 
-p prompt=03E 


In order to download a files for example "foo", use the com- 
mand 
protocol ~f dataio foo 
For uploading from the OATA/IOs the corresponding command 
file should contain: 
-s \VEVC86A\r2000-\rI CM\rO\r 


-u /dev/tty4 
“p prompt=03éE 


Naturallys other PROM programmers anc emulators will have 
different protocolss you will need to consult your manual 
for detailss and will probably have to experiment as well. 
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The following programs are supplied with the Object File 
Utilities for specializad purposass: 


mar 
mea 
MULMAQG@ec 


They are described below. 


11.1. MAR 

The mar utility is an older version of glib. It produces a 
somcalled “archive” file which is compatible with older ver- 
sions of mlink,s as well as the library files of the Berkeley 
version of the UNIX*® operating system. Archive files have 
the advantage of being able to contair any kind of file (not 
just MUFOM object filas)s and the disadvantage of not allow- 
ing the linker to access them randomly. 


The command line of gar is identical to that of mlib (see 
Chapter 4). 


11.2. M2A 

The ggse utility converts MUFOM object files to a form called 
aeoutes which is the format used in Zilog’s S800C microcom- 
puters. This format is primarily usefui for downloading 
into Zilog’s EMS~800G emulator for the Z8000 microprocessor. 


11.-2e1- Command Syntax And Options 


The nga conversion utility is invoked by the following com- 
mands 


méa C ~i | -o 3 C -s seg J inputfile outputfile 
The command-line options are: 
= 4. Put instructions and data in separate address spaces. 


-0 Convert an ovariay file. 
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-s H is the segment number Cin hexadecimal) in which the 
stack is to reside. 


The input file must be absolute, j.g. the output of 
mlink or gload- Many features of MUFOM cannot be con- 
verted to geQut-s these include arbitrary expressions 
involving relocatable or external symbolss and sections 
other than codes datas and &8SS. 


11.3. MUIMAGE.C 


The gyimagees program is the Crlanguage source for a pro- 
gram. It converts a MUFOM character form object file on 
Standard Input to an absolute binary image file on its Stan- 
dard OQutputs while producing a hexadecimal listing on Stan- 
dard Error (the terminal). This program is not very useful 
by itselfs but is supplied in source form so that you can 
construct a customized loader for whatever target system you 
are usinge muimege is designed to work on the output of 
migads and understands only absolute modules in character 
form. 


11-3-1. Command Syntax 


The gyimage conversion program is invoked by the following 
command: 


muimage Cinputfilej] > outputfile 


If no input file is specifieds Standard Input is used. 
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Aet. THE MUFOM STANDARD 


The MUFOM formats as implemented by the Zilog cross- 
software productss follows the format specified in the IEEE 
standard JEEFE §95-1985- "The Microprocessor Universal Format 
for Object Modules.” The standard specifies only the charac: 
ter form for object filess the binary ferm of MUFOM files 
follows the suggested format in Appendix 38 of the standard. 


Section A.2 discusses the concepts of modules and sections, 
and the various section attributes and their meanings. Secm 
tion A.3 discusses the way MUFOM handles symnbolss and the 


use of MUFOM variables. Section A.4 discusses tha local 
usage of IEEE Standard 695 by the Zilog cross~software,s 
including implementation restrictions. Section Ae5 


discusses local extensions to the standard that have been 
added to implement efficient library search. Section A.6 
contains an example of a MUFOM object module and an explana- 
tion of its constituent commands. 


Ae2e MODULES AND SECTIONS 


MUFOM object modules Cobject files) ere divided into s@ec- 
tions each of which is destined to be loaded into a separate 
area of memory. Each section has a gamer a <gize- attcic 
putes and (Cif not relocatable) a location. Each section 
also has a@ gaction oumbec which is used to refer to it 
internally. In Zilog’s implementation these section numbers 
correspond to the order of the sections in the section 
table. Section numbers are limited to 16 bits. The name 
and attributes of a section are specified in a MUFOM "ST" 
CSection Type) commands the size and location are MUFOM S- 
and L-variables respectively. 


It is important to note that the name of a section may be 
null Cin which case the section is referred to as 
"“unnamed")» and that the names of sections need oet be 
uniguge. Thuss a file may contain several sections named 
“cogde". The advantage of this is that the linker can relo- 
cate such sections separately. Therefores on a Z800T all 
“code” sections do not have to be in the same segment. 


Sections may also have an alignment and page size. The 
location Clower bound) of a section is restricted to be a 
multiple of its alignments and the section may not cross a 
boundary which is a& multiple of its page size. The page 
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size is used to implement address~space and segment-size 
limits. The alignment and page size of a section are speci- 
fied by the MUFOM "SA" (Section Alignment) command. 


The following is a description of the various section attri- 
butes and their meanings. This includes the way they affect 
the link processs ana their eventual use in a target system. 
Each attribute is represented by a letter (lowercase or 
uppercasa). 


Ae2eit. Access Attributes. 


The access attributes specify how sectisns are used 
Caccessed) in the target system. They are used during the 
link process to select groups of sections that ara to be 
located together. 


Ww CWriteable) 
This is the default access attribute. 


R (Read-only) 
This attribute is used for data that is intended 
to go into ROM. 


8 ¢€8SS) 
This attribute is used for data that is initial- 
ized to zero whan a program is started. (8585 
stands for "Block Started by Symbol”.) 


X CExecutable) 
This attribute is used for code sections. 


Z (Zero page) 
This attribute is used for sections that are 
accessed via a processor~dependent short address=- 
ing modes such as the Z8 on-chip registers. 


A CAbsolute) 
Sections with this attribute have been located at 
an absolute address. 


Ae2e2e Overlap Attributes. 


The overlap attributes specify how sections with the same 
name and same accass attributes are to be handled. Sections 
can be unnameds all unnamed sections are treated as if they 
have the same name. The overlap attributes are mutually 
exclusive and a section may have only gong of them. 
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S (Separate) 
All sections with this attribute will be kept 
separate when located in the output file. This is 
the default overlap attribute. 


C (Concatenate) 
Concatenate (combine into a single contiguous 
chunk) all sections with the same name and attri=- 
butes. This ettribute performs the equivalent of 
the lirnker’s “nm command line option. 


—£ €Equal Length) 
Overlap all sections with the same name and attri- 
butes,s, the size of the resulting section is the 
size of its componants. Produce an error message 
if they have different sizes. 


M (Maximum Length) 
Overlap all sections with the same name and attri- 
butess the size of the resulting section is the 
Size of its largest component. 


U CUnique Names) 
Only one section with the same name and attributes 
is permitted. 


Ae2e3de Allocation Attributes. 


The two allocation attributes determina the order in «thich 
sections are selected. 


N CNow) 
Selected sections with the "n”" attribute will be 
merged before all sections with the “p" attribute. 
This is the default allocation attribute. 


P (Postpone) 
Selected sections with the "p” attribute will be 
merged after all sections with the "n" attribute. 
When sections are selected via plack’s -s 
command-line arguments any “postpone” sections 
selected are placeda after any "now" sections 
selected by the same subrargument. Thuss 


“-s code data 


selects first the sactions with name “code” and 
attributes that include "“n"“, then sections with 
name "code" and attribute “p",» then sections with 
name "data" ana attribute "nn", and finally seco 
tions with name "date" and attribute "pp". 
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Ae3. SYMBOLS AND VARIABLES 


MUFOM modules associéte mumerical values with constructs 
called yeriabies- uhich are represented as a letter in the 
set o-Z followed by a@ hexadecimal nmunbers the jndex. In 
Zilog’s representations variable indices are restricted to 
16 bits. (Avoiding the letters A-F as variable identifiers 
means that variables can always be distinguished from hexa- 
decimal numbars.) 


Velues are assigned to variables with the MUFOM “as” 
CAssign) command. 


Ae3et1e Section Variables 


Some of the variables in a MUFOM module are associated with 
sectionss and their index is the same as the corresponding 
section number. These variabless and their neaningss are: 


$ Size of the corresponding section. 


L Location of the corresponding section. The Lo 
variable is present only for absolute sections. 


R "Relocation base” for tre section. In absolute 
sections this is initialized to the section’s 
locations in relocatable sections it represents 
the address at which the section will eventually 
be locetede 


P “Program Counter” for the section. In the load 
data of the modules the Pr-variable represents the 
next Location at which code will be loaded. Space 
can be reserved within a section by essigning to 
the P-variable. 


Ae3de2e Symbol Variables 


Other variables in a MUFOM module are associated with sym 
bols. The value assigned to the variable is the value of 
the corresponding assembly-language symbol. 


The symbol variables are: 


N N-variables are associated with jlecal symbols 
Cnames). It is possible to have more then one N- 
variable in a module with the sane name, this 
occurs when two modules containing local symbols 
with the same name are linked together. 
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I-variables are associated with globa} CiInternal) 
symbols. These are symbols defined within a 
module that can be referred to in other nodules 
that are linked with it. 


4 


xX X-variables ere associated with external refer- 
ences to global symbols in otnar modules. X- 
veriables are never assigned values. 


As implementea et Zilogs the Ns Iv ard X variables of 
@ny object module are allocatad contiguously starting 
from NOs 107 ana XGe The variable incices do pets how- 
@vers necessarily correspond to the order of the vari- 
ebles in the symbol table. It is only guaranteed that 
there will be no gaps in tha numboaring. 


Aare Other Variables 


Finally, there are two other kinds of variebles in MUFOM 
modules: 


G There is at most one Gw-variable in a MUFOM nocule-, 
its value is the gentry ggint or starting address 
of the program. 


i wovariables are "working registers". wWwG is used 
as temporary storage for range-checking. Thea 
other woevariables are used by the assembler to 
hold the values of foryvard referensas, that is, 
symbols that are used befors they are definad. 


A.4. LOCAL USAGE 


Aehe1. Connents 


There are two special local usages for comments. Comment 
levels G-3 are used for specific kinds of debugging and link 
mao information. Comment levels 1T00Ckax)-102 are used for 
separating the object file into regions containing different 
kinds of information. 


Ae4e4e1- Information Conmnents 


Information comments contain error messagess source code, 
and link nap information. They allow symbolic debuggers and 
other programs Cincluding odyma-e ung, and glist) to display 
more information than would otherwise aa present in the 
object file. 
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0 Comment level J is used for error nesssges. 
1 Comment level 1 contzins comments of the following 
forms: 


FILE Innnn Nnnnn Onrrnnannnnannnn filenameClibrary) 
Input file information. Ir Nv and 9 precede 
the I-variable origins Nevariable origins and 
creation date respectively. 


sSeECT isecn osecn Lennnnnnnn S=nnnnrnann ifilessecnanezsatts 


Link map information on input sections. 


filename: Linenumber 
Compiler filename and line number from .FILE 
and eLINE assembler statements. 


2 Comment level 2 contains assembler source lines. 


3 Comment level 3 contains assembler listing format 
informations in comments of the form: 


filenames lLinenumber 
Assembler source file and line number. 


sPAGE 
marks a new listing pege. 


Acehete2e Object File Regions 


Three special comments divide the object file into regions, 
as shown in Figure Aw1. The region before the first such 
comment is the file headers containing the MBs ADs, and OT 
commnands. 


100 A comment of level 160 Chex) introduces the section 
tables containing ST, SAs ASLs and ASS commands 
and the input file and link map comments. 


401 A comment of level 167(Chex) introduces the symbol 
tables, containing Ni» NXe NNv ASIe ASNe ASGr WXe 
ATs LIs iXr RIv and TY commands. 


102 A comment of level 1C2Chex) introduces the load 
data regions containing ASWs $8 ASPs LDs LRo IRs 
and RE commands and comments containing error mes- 
sagess assembler sources and $0 on. 


Splitting object files into these regions makes the linker 
and other utilities more efficient by marking parts of the 
file that do not neea to nae processed. 


\ 
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| Module Naader 


TE TD OPP De SPH SC SCSOSSGOe BOOP esD Wee esheanaesesese GO Be ee ww 


SSeS eeeeeaeas OQ @ @O@oeoes een eenoneseaesh ea @eoeoee @] we @ ee we 


| Section Table | 
| i 
{ | 
i Symbol Table | 
| | 
i | 
j Program Section } 
| ! 
| Module End { 


Figure A-1. Cbhject Module Regions 


Ae4e2- Expressions 


The MUFOM standard permits the use of expressions of great 
generality in many places in the object files. khat the 
linker and other utilities will agsest iss in generals nore 
restricteds and what the assemblers linkers and other utili- 
ties will emit is more restricted still. 


In this sections codes are used to indicate the kinds of 
expressions that are acceptable. Except whan only 
hexnumbers are permitted, all] functions are allowed. The 
codes are: 


Hnn any hexnumber of at most nn bits. 
R R-variables. 
Wi wevariables. 
X Xevariahbles. 


As a@ rules other variables ere not used in expressions, all 
utilities expand them into equivalent axpressions involving 
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Re Wer end X variables. w92 is used purely as a temporary 
for Limit checkings other wW variables are usea by the assen- 
blers for forward references. 


Indices All variable indices and section numbers 
are H16’s. 


Addresses All addrasses are limited to 32 bits (H32 


RWX). 

Numbers Numbers up to 8C bits (480) are permitted 
in assignments and LR commands. 

SA Section Alignment: H32s Page Size: H32. 

CO Comment level: H16. 


AS(@GrIsN) H8C RX. 


ASCRo Pd H32 R. 

ASW H80 RWX. 

LR HSO RwX. 

IR Relocation Base: H8C RWX- Number Of Bits: 
HS. 

RE H32. 

wX 480 RwX. 


Ae4e3. Command Order 
There are some local restrictions on the ordaring of MUFOM 


commands. Observing these restrictions makes it possible to 
avoid retaining information that will not be needed later. 


Ae4e3-1. Section Information 


All the information for a single section is grouped 
togethers with the ST command firsts followed by the SAvs ASL 
and ASS commands in any order. The ASS command must be 


presents and the section size must be a hexnumber. 
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Ae4.3e2- Variable Information 


All the information for a single variable is grouped 
together, with the Nv command first. 


An NIv or NN command is always followed immediately by the 
corresponding AT command (Cif any) ana ASI or ASN command. 


An NX .command is always followed immediately by the 
corresponding AT and WX commanass if anya. 


wevariables must be assigned to before they are referenced. 


R-variables are assigned implicitly. No existing utilities 
generate ASR commands. 


Ae5. LIBRARY EXTENSIONS 


The following commands have been added for maintaining 
libraries. <A library file consists of a library headers the 
modules in the library, and a library map. The library 
beader consists of an LB commands an optional OT command, 
and an LE commande The Jibrary yap is at the end of. the 
file, and consists of a series of LM commands followed by an 
LE command. The library extension commands are always in 
character forme Modules contained in a library may either 
be in character form or binary form. 


L3 map_position "“,/" lib name “."™ 


Library Begins the first commangq in a library. 
The hexnumber map position is the position in the 
file of the library maps which consists of LM com 
mands followed by an LE command. 


The L&8 command may be followed by a OT command 
with the date the library was created or last 
modified. This is followed by an LEs the MUFC 
modules contained in the librarys and the library 
M2De 


Lé ere 


Library End: marks the end of the library header 
and the library map. 


LM position "-" size *s" m name ("%-s" Iomamed*e C€", 
wy ice sale x nama) x) mere 
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Library Module: indicates the position in the 
library of a modules its size in bytess its name, 
the names of the symbols (CI-variables) it definess 
and the names of the external symbols (X= 
variablas) it references. 


Ae6- EXAMPLE: Zilog MUFOM Module 
Figure A=-2 shows an actual character-form MUFOM module oro- 
duced by a Zilog MUFOM Cross-assemblar. Line numbers have 


been edded in parentneses along the right margin for refer- 
ence purposes. 
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M8Z8200,06link.0.« 
0719356522102255. 

ADD&sO2rL. 

C00100s17---- Section Tabla ----. 
STCOsX-A-C4e0dee 

ASLO090. 

ASSCC,31. 

STC1 Wr Ar Chdata. 

ASLC1,31. 

ASS01/0C. 

STO2-3-WeCr Ae OOCOMMONS 

ASLO2-30. 

AS$02,-10. 


€00101716~---- Symbol Table ----. 
NNC1-C@be_store.e 
KESNC1/21. 
NNO2sOSbcS$AlL. 
ASNC2,-28. 
NIOOsO3div. 
AS10000. 
NIO1-09dvd_store. 
ASI01,-33. 
NNO3S/O04divi. 
ASNC3-09. 
NNC4sC4dive.e 


ASNO4,18. 


NIO2s/O9mpy_ store. 

ASI02-30. 

ATIC2,00-00-10-02. 

AS3,00. 

C0OO0102-1A---- Program Sections --~-. 

$800. 

ASPC0-CO. 
LREBC544402100003E1087C813C3812C815CB14CD0280CDA1800 
EN42ZICSOC2ZO9OOCTEB2237200223000CVESB7EO422231090S1C9. 
$801. 

ASP01-31. 

LrodgdQdOoOooCCOoOoROCOCONS. 

$802. : 

AS°02-,3D. 

CCFF-208SS Cuninitialized data) section. 

ME. 


Figure Aw~2. MUFCM Module 
nes €1) - €3) define the module header. The module 
stancard across all Zilog MUFOM object modules. 
- Module 3egin 
o Defines the start of a MUFCM object module. 


o Defines the target orocassor type Coptional). 
9 Oefines the object module’s name Coptional). 
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FORMAT 


(1) 

(2) 

(3) 

(4) 

(5) 

(6) 

(7) 

(8) 

(9) 
(10) 
(11) 
(12) 
(13) 
(14) 
€15) 
(16) 
(17) 
(18) 
(19) 
(20) 
(21) 
(22) 
(23) 
(24) 
(25) 
(26) 
(27) 
(28) 
C29) 
(30) 
(31) 
(32) 
(33) 
C34) 
(35) 
(36) 
(37) 
(38) 
(39) 
(40) 
(41) 
(42) 


header 
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OT - Date 
o Defines the object module’s creation time and date. 


AD - Address Descriptor 
9 Defines the number of bits per Minimum Addressable 
Unit CMAU). 
o Defines the maximum size of the target processors 
address space in MAUs Coptional). 
o Defines the order of the address’s MAUS within the 
object code. 


Line (4) = MUFOM comment commands are used in the Zilog 
MUFOM implementation to delimit the different parts of the 
object module. Line (4) daelimits the start of the Section 
Table. Comments are prefixed by the MUFOM CO command. 


Lines (5) ~- (13) are the section table. iach section within 
an object module will have a set of description commends in 
this table. MUFOM commands that are used in the section 
table region of the mocule are. 


ST - Section Type. For a given sections defines 
o Section type attributes Coptional) 
9 Section name (optional) 


SA = Section Alignment. For a given sections, defines 
o Section alignment (given in MAUS) Coptional) 
o Msximum section size Coptional) 


AS ~ Assignment 
o 6ASSigns values to section variables 
S$ * section size 
iL - location of section’s lower boundary (optional) 


Line (14) - The start of the symbol table. 


Lines (15) - (30) ~ The symbol table contains declarations 
for all of the global, externals and local symbols within 
the object module. Assignment of absolute values or expres- 
sions to symbolss definition of symbol type, and definition 
of symbol attributes zre kept here. The module’s entry 
point, if anys is also specified here. M‘MUFOM commands used 
in the symbol table region of the object file are 


NI > Name Internal (Slobal) Symbol 
o Oeclares an external symbols a table entry numbers 
a name length counts and gives its name. 


NX ~ Name External Symbol 
o Oeclares an external symbols a table entry number, 
a name length counts and gives its name. 


NN = Name Local Symbol 
o Declares a local symbols a table entry numbers 2a 
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name length counts and gives its name. 


AT - Symbol Attribute. Cefines for a given synbol 

Type table entry 

Lexical level Coptional) 

Size (used for common symbols) Coptional) 

Alignment (used for processors where variables must 
be aligned on specific addresses) Coptional) 


0a0ao00 


AS - Assignment. 
® Assigns a value or expression to a symbol. 


TY - Type. Oefines a type table entry. 


WX - Weak External. 
o Oefines a& given symbol as a weak external. 
o 6©Provicdes a default value or expression to be 
assigned if the symbol is not resolved. 


Line (€31) The MUFOM comment used to delimit the start of the 
program portion of the object module. 


Lines (32) =- (41) The codes or load datar portion of the 
object module is kept in this region. The heading "Proegram 
Sections” refers to the MUFCM sections which are the logical 
divisions of the progran. MUFGM commands used within this 
region to define the code are 


SB - Section Begin 
®9 Declares that the following code belongs to the 
specified section. 


tO - Load. 
o0 Contains object code. 


LR = Load Relocate. 
eo Contains code and relocation expressions. 


IR - Initialize Relocation Sase 
© Assigns a value to 2 relocation letter. 


RE - Replicate. 
9 Repeat the immediately following LK expression a 
specified number of times. 


AS - Assignment 
o Assigns a value or an expression to a section’s P 
Cload pointer) variable. 


* A weak external will be resolved with a giobal 
definition if one is presents otherwise it receives the 
cefault value specified in the Wx command. 
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Line (42) The end of a MUFOM object Module is delimited by 
the ME Comnand. 
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Appendix 8 
TEKTRONIX HEX FORMAT 


8.1. RECORO FORMAT 


Kecord Format 


field name: } SR ADDR RL CS1 «eee DATAxaxax CS2 END | 
field size: { 1 ¢ 2 2 0-255 2 1 | 


Figure 8-1. Tektronix Hex Record Format 


SR-~Start Record Field (frame 0) 
The ASCII slash character (/) is used to signal the 
start of a record. 


ADOR--Load Address Field (frames 1 to 4) 
The starting location in menory to/from which data will 
be loaded/seved. 


RL--Record Length Field (frames 5 and 6) 
Tha number of data bytes in the record is represented 
by two ASCII hexadecimal digits. 


CS1i--First Checksum Field (frames 7? and 8) 
This checksum is the 8=bit sum of the six hexadecimal 
digits that make up the load address and record length. 


DATA~-Data Field (frames 9 to 9 + CRL * 2) -1) 
Each pair of frames in tre data field represents a data 
byte, where each frame contains the ASCII representa- 
tion of a 4-bit value. 


CS2-~Second Checksum Field (frames (9 + (RL * 2)) and «9 = + 
CRL * 2)) + 1) 
This checksum is the sum of the 4-~-bit hexadecimal 
values of the digits in the data fields nodulo 256. 
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END~~Etnd of Recora Field (frame (9 + CRL *® 2)) + 2) 
The ASCII code for a carriage return is used to signal 
the end of a record. 


Bede END-OF“FILE RECORD FORMAT 


The end~of~file record has a record length of Os the address 
field containing the entry point addresss and no data or 
second checksum. 


Example 8-1: /4F000013<CR> 


B.35S- ABORT RECORD FORMAT 


The download operation can be aborted by the host system 
sending an abort records consisting of two slashes followed 
by 2@n error message and carriage return. 


Example 8-2: // PROGRAM ABORTED <CR> 


B.4. HANDSHAKING FOR DOWNLOAD/UPLOAD 


mload and msend use the Tektronix handshaking protocols by 
defaults for each format. Since there is no handshaking 
used in conjunction with the Intel Hex formats the ~h option 
must be used to turn it off whenever the ~i option is speci- 
fied. The handshaking protocol consists of three signals: 


o «€6©"™0")6=6OUNNO error o ait had Sad records retransmit o "gr 
Abort 


These signals are sent by the target to the host when down- 
loading and vice versa when uploading. 


It is recommended that handshaking always be used to prevent 
erroneous data transmission. 


N) 
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INTEL HEX FORMAT 


C.o1. RECORD FORMAT 


Record Format 


field name: | SR Rk ADOR RT xeeeDATAxeee (CS | 
field sizes | 1 2 4 2 0-255 2 | 


Figure C-1. Intel Hex Record Format 


SR--Start Record Field (frame 0) 
The ASCII character colon (3) is used to signal the 
start of a record. 


RL--Record Length Field (frames 1 and 2) 
The number of data bytes in the record is representea 
by two ASCII hexadecimal digits. 


ADDR--Load Address Field (frames 3 to 6) 
Four ASCII hexadecimal digits representing zeros or the 
address to/from which data will be loaded/saved. 


RT--Record Type Field (frames 7 and 8) 
The ASCII hexadecimal digits in this field specify one 
of the record types shown in Table C-1: 


Table C-1t. Intel Hex Record Types 


Record 
Type Description 
00 Deta Record 
01 end~of~File Kecord 
02 Extended Address Record 
03 Start Adaress Racord (Centry point) 


The address specified by the Extanded Address Record is 
left-shifted four hits (representing the four most signifi- 
cant bits in a 20-bit eddressds and added to all subsequent 
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type 00 (Data Record) addresses. 


DATA--Data Field | 
each pair of frames in the data field represents a data 
byte, where each frame contains the ASCII representa- 
tion of a 4*bit value. 


CS--Checksum Field 
This field contains the ASCII representation of the 
two’s complement of the sum of the data bytes Ceach 
pair of data field frames converted to one binary 
byte)d,s modulo 256. 
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ERROR MESSAGES 


D.1. INTRODUCTION 


cach utility describes errors with clearly stated error nes- 
sageSe There are thrae types of errors that can occur: 
process errorss input format errors,s and internal errors. 


The action taken due to an error depends on the severity of 
the error and the utility being executed. Most errors do 
not interrupt object module processing. 

De1.1. Process Errors 

Process errors occur due to either incorrect command usage, 
or otherwise-correct command usage on inappropriate data 


Cfor examples attempting to load a relocatable file). 


Process errors can occur 





rs) While attempting to interpret the conmand line used to 
invoke the utility. 


° During the processing of object modules. 


De2- COMMON ERRORS 


The following errors are common to most or all of the utili- 
ties: 


De2Zete Command Line Errors 


The common command line errors are 


~<letter> argument filenane missing 

-<letter> argument number missing 

garbage after numeric argument: ~<letter> 

unrecognized command-line argument ~<letter> 

-<letter> argument inconsistent with previous arguments 
extra output falerame ignored 
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Dede2e Other Errors 


OPEN error on file <file name> 
can’t handle libraries 
division by zero 

no free storage left 

value out of range 


An OPEN error means either that a specified input file does 
not exist or is protectsdaq against reading, or that a speci-~ 
fied output file is protected against writing. 


“No free storage ieft" means that there are too many syn 
bolss sectionss or filas in the input. 


The “division by zero” and “value out of range” errors 
represent errors in assembly-language code which could not 
be detected by the assembler because they involved relocat- 
able or external symbols. 


D.3. COMMAND-SPECIFIC ERRORS 
0.3.1. mlib Errors 
The errors unique to glib are 


unknown option “°<letter>’” 

Can not read °<filename>’ 

Must have exactly one of “’dsaqsrstsx’ 

No archive file specified 

Only one option allowed in “dsvasretsx’ 
archive file ‘<filename>’ not found 
missing argument for “f° options 
nultiple “<letter>’ options 

SuLilLdGLM ~- ‘°<fililaname>’ Not archive format 
SuildLM ~ Out of nemory 

Bu1rldlLM - no matching LE 

CreatMlib - Can not create “<filename>’ 
Out of memory 

WritaAll ~ Can not create *°<filename>’ 
WriteAll - Can not open “<filenamea>’ 
can’t handle libraries 

q_mlib - Cut of memory 

x _mlib - Can not create *<filename>’ 
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Dedede mliink Errors 
The errors uniqus to glink «ere 


- without attribute in select string <arg> 
-m not implemented in relocatable link 
-t argument adaress missing 
-<symbol> =value with no symbol 
-<symbol> Llangth with no symbol 
-t cannot relocate absolute section 
—~t with no sections selected 
+symnbol: symbol missing 
=value: value missing 
E section attributes sections must have same size 
U section attributes sections must be unique 
attempting to merge 
absolute section <section descriptor> 
with reloc. section <section descriptor> 
entry point <symbol> undefined 
file <filename> has different address order 
illegal character in select string <erg> 
multiply-defined global symbol <symbol> 
nested -f files not allowed 
output file <filename> is also an input file 
symbol <symbol> not absolute 
undefined axternal <symbol> 


0.3.3. mlink Warnings 


The only utility that generates warnings, as opposed to 
errors, is mliok.e harnings represent unusual conditions 
thet mays nevertheless, be what you intended to produce. 
The ~w sption to glink suppresses these warning messages. 


address space overflow at <address> 
attempting to load into &8SS section at <address> 
no section information for section <number> 
no section information in input file <fileneme> 
null select: <aerg> 
null unselect: <arg> 
section overlap 
<section descriptor> 
<section descriptor> 
symbol <symbol> redefined by ~g argument 


The “section overlap” errors in particulars can occur when 
making files with separate address spaces for instruction 
and data. The "no section information” errors occur when 
linking files generated as output from gloag without the -s 
option. 
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003.4. mlist Errors 


There ara no arrors actually unique to plist but errors 
included as level-C commants by the assembler are ancluded 
in the listing. 


D.3.5-. mload Errors 
Tha errors unique to gloeadg are 


section <name> is relocatable 


D326. mlorder Errors 
The errors unique to glorder are 


<symbol> multiply defined in <filename> and <filename> 
cannot open <filename> 

cycle in datas 

extern overflow 

module averflow 

out of memory 

symbol space overflow 

text spaca overflow 


0.3.7. protocol Errors 
The errors unique to protoesol are 


too many files 

write record error 

write first °G°’ error 

cannot open <filename> 
conflict -d & -u options 
duplicate -<letter> options 
invalid -r option ~- <string> 
invalid -t option - <string> 
no file specified ; 
unknown handshaking code <number> fron Remote 
unrecognized option <string> 


0.4. INPUT FILE FORMAT ERRORS 


Input File Format Errors are primarily associated with the 
parsing and execution of MUFOM commands (Cas opposed to util- 
ity program command lines) within a MUFOM object file. 
These errors are displayed in ane of two formats: 
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input file format errors MCe at line 9 of f00.0 
or 


input file format error: MCE at line 9 of fo0.0 
MCE: missing command-erd period 
byte Oxa of the MUFOM command: 
NNO1sxxxs2G4tfoot. 


The second, more descriptive format is obtainable via tre >= 
v4 option in wmjiok. If the ineut file is in binary form, 
tre Line number is replaced by an offset in characters from 
tne beginning of the file. 


It is generally impossible to get format errors unless 46 
MUFCM file has bean sarbleds or generated incorrectly. This 
usually is caused by a bug in one of the utilitiess and 
should be called to the attention of your Zilog representa- 
tive. 
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Table O-1. Input File Format Errors. 


249: 
AOR: 
ARG: 
ASG: 
ASI: 
ASL: 
ASS: 
ASX: 
CMO: 
cOFS 
EXPs 
EXUs 
IAF: 
IAH: 
ILFs: 
LIS: 
MAUS 
MCEs 
MCP: 
MCS: 
MEXs 
MMB? 
MRO: 
MRPs 
MSA: 
MST3 
N16: 
N32: 
NEOs 
NAN: 
NNRs 
STL: 
TYUs 
TYV: 
UAT: 
UEX: 
UFNs 
ULODs 
USAS 
UXPs 
VAR: 
XEXs 
XMBs 
XRPs: 


2 hex digits required 

address > 32 bits 

not enough arguments for function 
multiple assignments to Grvariables (entry points) 
variable index of ASI does not match previous NI 
ASL commana before or without ST 

ASS command before or without ST 
assignment to X-variable is illegal 
command expected/undefined comnand 
unexpected end-of-file in <filename> 
expressions not permitted in download 
expression stack underflow 

invalid archive format 

invalid archive header 

invalid library format 

library command inside module 

can’t handle MAU length other than 8 bits 
missing command-end period 

missing comma or period 

missing command start 

missing expression 

M3 command missing 

missing relocation offset 

missing °)° 

SA command with no expressions 

no ST for section <number> 

number > 16 bits 

number > 32 bits 

number > 80 bits 

not a number 

not a number or R-variable 

string > 127 characters long 
unexpected TY-component 

N-variable or T-number expected 

AT command does not apply to previous variables 
unknown/invalid item in expression 
unknown operator/ function 

invalid load item 

SA command before or without ST 
unexpected reference to P-variable 
undefined variable 

too many expressions 

MB command not at beginning of file 
unexpected °)”’ 


D.5- INTERNAL ERRORS 


Internal errors generally indicate a bug in one of the util- 
ities; they represent conditions that should not occurs, and 
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should be called to the attention of your Zilog representa- 
tive. 


READ error on file <filename> 
<upload/download> read error 
weite error 
core dumpea 


The “core dumped” error is a host operating systen error 
which usually means that something drastic is wrong with the 
programs but it can also occur if a program runs out of free 
storage and fails to detect the fact. 
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absolute codes Code whose position within memory has been 
defined end whose eddress references have been assigned 
values relative to the code’s position. 


absolute loaders A process which can load one or wore sec- 
tions of absolute code only at the locations specified by 
the sections. 


checksums A semicrancdom function of @ file’s contents. If a 
file is copied and the checksum of the copy is different 
from that of the originals there has been an error in copy 
ing. 


codes A program or segment thereof uhich has been encoded in 
@ language useable by a processor. Often used loosely as a 
synonym for “load data". See Object Code, Source Code. 


commands Control information for a linker or loader. It is 
to be distinguished from Load Data. 


external references The usages within 2 modules of a syabol 
which is defined outsida that module. An inported global 
definition. 


files A MUFOM object file is a structure dafined by the host 
operating system containing ore or more MUFOM object 
modules. Files containing more than one module are con- 
sidered to be libraries. 


global definition: The definition within a modules of a sym 
bol which may be used outside that module. 


identifiers: A string of characters which uniqualy represents 
a defined entity such as a symbols option or command. 


library: A set of two or more object modules. 


linkers A program that combines object modules into a single 
object module satisfying links between the object modules. 


lead datas dJata Cinciuding machine instructions) to be 
loaded into a processor’s memory. 


load pointer: A pointer for a section which is dynamically 
maintained by the loader. It indicates where the next iten 
of the code is to be loaded. It is initialized to a start- 
ing load address. 
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local syabol: A symbol which is accessible only within a 
Single module. 


machine codes Code that is directly understandabla by a 
processor’s hardware. Since digital processors are binary in 
matures, machine code consists of binary numbers. See Object 
Code. 


module: A program or portion thereof, usually in the form of 
a separate file. See Object Modules Source Module. 


object code: Code (Load Data) sontained in an Object Module. 


object format: The language in which Object Modules are 
specified. 


object modules A MUFOM object module is a set of sections of 
absolute or relocatéeble machina codes together with ancil- 
lary commands. See Modules Source Module. 


prelinks: A link session that precedes one or more other link 
sessions over the same object code. 


program: An algorithm and associated data. A series of 
operations to be performed over some given data. 


process: A program executed by a processor. 

relocatable code: Code that consists of machine code ane 
relocation commands. Relocation commands allow address 
references within the machine code to be reevaluated if the 
machine code is repositionad in memory. Relocatable code is 
to ke distinguished from absolute code. 


section: A part of a program with ancillary information 
Ccommands) which becomes a segment when loaded. 


segment: A contiguous region in memory with arbitrary boun- 
caqaries which may contain machine code. 


source codes A program in some humancreadable programming 
language. Source code is translated into Chject Code by a 
compiler or assembler. 

source modules A Module containing Source Code. 


symbol: A label or name that represents a numeric value. 


symbol resolution: The process of replacing an external 
reference with its globally defined value. 
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ORDERING PRODUCTS 


Orders placed for Zilog components should include the component part number as shown in the example below. 
The part number consists of a “Z” prefix, followed by a five-digit part number, two-digit numerical speed designator, 
alpha package designator, alpha operating temperature range designator, and an environmental flow designator 


(e.g., Z8032008VSC or Z0840006VEC). 


ORDERING CODES 
PACKAGE 


IC PACKAGE CODES 


A = VOFP (Very Smail QFP) 

C = Ceramic Side Brazed 

D = Cerdip 

E = Ceramic Window 

F = Plastic Quad Flat Pack 

G = Ceramic PGA (Pin Grid Array) 

H = SSOP (Slim Small Outline Package) 
| = PCB Chip Carrier 

K = Cerdip Window 

L = Ceramic LCC (Leadless Chip Carrier) 
P = Plastic DIP 

S = SOIC (Small Outline Integrated Circuit) 
V = Plastic Leaded Chip Carrier 


SUPPORT TOOL PACKAGE CODES 


T = Emulation Module 
Z = Support Tools 


ENVIRONMENTAL 


PREFERRED 
C = Plastic Standard 
E = Hermetic Standard 


LONGER LEAD TIME 
A = Hermetic Stressed 
B = 883 Class B Military 
D = Plastic Stressed 


TEMPERATURE 


PREFERRED 
Standard: S = 0°C to +70°C 


LONGER LEAD TIME 


Extended: E = —40°C to +100°C 
(—40°C to +105°C for Consumer Products) 


Military: M =-55°C to +125°C 
EXAMPLE 


Z84C0010PEC is a CMOS 8400, 10 MHz, Plastic, 
—40°C to +100°C, Plastic Standard Flow. 


Z 84C00 10 P E C XXXX 


_ 


Special Lot Number 
(Optional) 

Environmental Flow 

Temperature 

Package 

Speed 

Product Number 

Zilog Prefix 
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1. Terms: Net 30 days 


2. Order/Shipment Minimums: 


A. 


Commercial Standard Product 


- $500 per order 
- $250 per line item and/or shipment release 
- 100 piece minimum quantity/line item per release in multiples of tube, tray, or reel count 


Custom ROM Products 


- 10,000 unit order minimum for 18-, 28-, or 40-pin devices 
- One-half of the units to be scheduled within ninety (90) days 
- $3,000 mask charge for each new ROM 


Non-Standard Product 


Windowed Products 

Systems 100 piece minimum waived 
Development Boards $250 line item minimum still applies 
Emulators 

Software 


Tape and Reel 


-  44-lead PLCC 500 units per reel minimum 
- 68-lead PLCC 250 units per reel minimum 


Trays 


44-lead QFP = 96 pieces per tray. 
80-lead QFP = 50 pieces per tray. 
100-lead QFP = 50 pieces per tray. 
48-lead VQFP = 60 pieces per tray. 
100-lead VQFP = 90 pieces per tray. 


Technical Publications 


- $100 per order or shipment release 
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3. Cancellation, Reschedule, and Failure to Release 


If buyer cancels shipment of any purchase order or a portion of any purchase order or reschedules without prior 
agreement by Zilog, any purchase order or a portion of any purchase order, the following charges may, at Zilog's 
option, be assessed and invoiced by Zilog: 


*Notice Received Prior to 
Product Type Acknowledgment Shipping Date Cancellation Reschedule Charges 


Commercial 0 - 30 Days No cancellations allowed. 
100 per cent Invoice charges apply. 


Military 0 - 90 Days No cancellations allowed. 
100 per cent invoice charges apply. 


ROM* 0 - 90 Days No cancellations allowed. 
100 per cent Invoice charges apply. 


Remote Control End Products 0 - 90 Days No cancellations allowed. 
100 per cent Invoice charges apply. 


Note: 
* Notice shall be calculated from the customer request date. 


ROM Code Variations 


Because ROM Coded Products are custom products made specifically for Buyer, Buyer agrees that Zilog may ship 
a quantity of such ROM Coded Products which is five percent (6%) more or less than the quantity ordered and 
that such variation will be accepted as delivery in full and paid for by Buyer. 


Zilog price quotations and acknowledgments are dependent upon quality and schedule. If the Buyer does not 
release the full quantity quoted and acknowledged within the time frame stated on the quotation, Seller reserves 
the right to either invoice the full quantity quoted and acknowledged within the time frame stated on the quotation 
or to invoice for a higher price in accord with Seller's price schedule for the lower quantity actually released by 
Buyer. 


4. Product Availability 


Product availability is a function of a constantly changing market and manufacturing conditions, therefore Zilog 
cannot guarantee availability. Please contact your local Zilog sales office or sales representative for current 
product availability information. 


Information for products not listed in this selection guide can be obtained from your local Zilog sales office, or sales 
representative. The point of delivery will be determined by the Zilog sales order acknowledgment. 


5. Cost Adders 


Special processing of both commercial and military products to the customer's specifications (non-Zilog standard) 
is available in the following circumstances on most Zilog products: top mark, packing instructions, shipping 
instructions, one lot date code per shipment, stepping qualification, and certificate of conformance (C of C). Read 
Only Memory (ROM) mask charges are required for ROM coded products. For information regarding charges and 
possible delays which special processing may have on delivery dates, contact your local Zilog sales office or sales 
representative. All prices quoted apply to orders placed worldwide, excluding VAT, tax, freight, duties, and 
exchange rate variations. 
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Special Services and Prices 


Military Grade Components - The following cost adders should be used if standard military specifications are not 
adequate for a given requirement: 


Condition Charge 


Generic Data 


1. Group “A” - Sample Electrical Test, per generic part type $100.00 
2. Group “B” - Assembly Construction Test, per generic part type $100.00 
3. Group “C” - 12 week results on JAN product/Die Life Test - 

52 week results on non-JAN product $100.00 
4. Group “D” - 26 week results on JAN product/Package Life Test - 

52 week results on non-JAN product $100.00 
5. Generic Data Pack - Includes Groups A, B, C, D data $300.00 


Customer Specific Data 
1. Group “A” - done on customer parts $100.00 
2. Group “B” - done on customer parts $600.00 


3. Group “C” - done on customer parts (per device type). 
Delivery increased eight weeks. $1200.00 


4. Group “D” - done on customer production lot, excludes 
destructive test part cost of 50 parts at customer's price. 
Delivery increased three weeks. $2500.00 


Additional Requirements 


1. Particle Noise Detection (PIND) testing $250.00 minimum 
Minimum charge per line item, per part, per order. or 25.00 per unit 
Lot acceptance will conform to 883 Rev. C method 2020.5 
allowing up to 25% lot defective maximum, pass on 1% PDA. 


2. X-ray screening per Mil Std 883C $500.00 minimum 
or 5.00 per unit 

3. Lead finish other than solder dipped Contact Factory 

4. Special top marking requirements $250.00 minimum 
or 2.50 per unit 
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General Terms and Conditions of Sale 


Special Services and Prices 


The final character in the DESC drawing number (“X”) refers to the type of lead finish the parts must have. An 





“X” indicates that any lead finish (Solder = “A,” Tin Plate = “B,” Gold Plate = “C’”) is acceptable. It is the standard policy 


of Zilog to only offer the “A” lead finish which is solder dipped (ex. 5962-8551 802QA). 


Notes: In general, if special processing is required and is not listed above, it is not available. However, call 


your local Zilog sales office to discuss requirements as necessary. 


Condition Charge 
Initial customer qualification of products in place of Zilog Customer pays for 


qualification report. 


Customer Change Notification 


qualification sample 





1. Notification to customer of product tooling revision 0.10 per unit 

2. Notification to customer of process change 0.10 per unit 

3. Customer approval of process tooling revision 0.30 per unit 

4. Customer approval of process change 0.20 per unit 
Special customer top mark & special customer logo 

(case by case basis for some requests) 0.10 per unit 
Special customer burn-in in place of Zilog standard 0.50 per unit 
Special customer final test 0.50 per unit 
Final test data recording 1.00 per unit 
Test data recording before and after burn-in 2.00 per unit 
Special shipping containers Cost plus 15% 
Special shipping container marking in place of Zilog standard 0.05 per unit 
Special safety stock in place of Zilog standard 0.20 per unit Mm 
Special shipping routine to point-of-title transfer in place of Zilog standard 0.10 per unit 
Date code requirement in place of Zilog standard 0.05 per unit 
Certificate of Origin with shipment 20.00 per shipper 
Certificate of Conformance 5.00 per shipper 
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CEN SiLGE General Terms and Conditions of Sale 


Special Services and Prices 


Condition 
Tape and Reel (where available) 
- 44-lead PLCC 500 units per reel minimum 
- 6§8-lead PLCC 250 units per reel minimum 
Special tube stoppers - rubber plugs 


Special 100% full functional final test at hot 
temperature before burn-in 


Special die orientation - die bonded upside down and 
rotated 90 degrees from JEDEC standards 


Special back mark instruction 


Special shipping box - parts to be shipped in a box lined 
with conductive material or static shielding bags 


“Dry Pack” of PLCCs in place of normal 
Special tube orientation indicator mark 


Parts requiring retest 


Programming Z8/OTP 


Failure Analysis 


Single date code per shipment/line item 


Charge 
0.10 per unit 
0.20 per unit 


0.05 per unit 


0.05 per unit 


0.10 per unit 


0.10 per unit 


0.05 per unit 
0.30 per unit 
0.05 per unit 


10.00 per military unit, 
0.30 per commercial unit 


500.00 minimum per order 


200.00-600.00 for military, 
depending on test requirements 


100.00-400.00 for commercial, 
depending on test requirements 


500.00 minimum or 5.00 per unit 





A ZiLAS 


Trays: 


100 


100 


68 
84 


VOFP: 
VOFP: 
VOFP: 


QFP: 
QFP: 
QFP: 
QFP: 
QFP: 


SSOP: 


PCB Chip Carrier (C3) (not shipping yet): 
PCB Chip Carrier (C3) (not shipping yet): 
PCB Chip Carrier (C3) (Not shipping yet): 


General Terms and Conditions of Sale 


Shipping Requirements for Plastic Packaging 


90/tray 
60/tray 


160/tray 


66/tray 
36/tray 
24/tray 
66/tray 
96/tray 


68/tray 


Plastic DIP: 
Plastic DIP: 
Plastic DIP: 
Plastic DIP: 
Plastic DIP: 
Plastic DIP: 
Plastic DIP: 


SOIC 
SOIC: 
SOIC: 


PLCC: 
PLCC: 
PLCC: 


Tape and Reel: 


S 


18 
20 


44 
68 
84 


40 


27 


25 


15 


450/bag 
600/bag 
800/bag 


660/bag 
360/bag 
240/bag 
660/bag 
960/bag 


units/rail 
units/rail 
units/rail 
units/rail 
units/rail 
units/rail 
units/rail 


40/rail 
40/rail 
30/rail 





units/rail 
units/rail 
units/rail 


units/rail 
units/rail 
units/rail 


SOIC: 
SOIC: 


PLCC: 
PLCC: 
PLCC: 


2,000/reel 
2,000/reel 


500/ree! 
250/reel 
250/reel 


1000/bag 
950/bag 
1080/bag 


500/bag 


400/bag 
225/bag 
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ZILOG DOMESTIC SALES OFFICES 


AND TECHNICAL CENTERS 

CALIFORNIA 

PQ OUI As cs: cudetarie teh verter eae aentenens 818-707-2160 
Campbell csuscaicitesccessateceatoekonccermescamenspecseanens 408-370-8120 
NPIS a cssereucrGentaceecttataoctcteasketectocstiislenmenclcaviind 714-453-9701 
Sa DIB OO accuse. axeesticOcicioekorcereesesnaneracousoes: 619-658-0391 
COLORADO 

OU GG cactswacscacannerideratsoleenaterets whee aeks 303-494-2905 
FLORIDA 

CNS AR WARSI sre ec Sts palin dicta ewer 813-725-8400 
GEORGIA 

PGT cise cya ice nes eeetnaa. cuir waraiechaneieutncmueceeen: 404-931-4022 
ILLINOIS 

SCHAUMD UNO at ssavissssuacessadersPacsrarsedsares nnn 708-517-8080 
MINNESOTA 

MINN@APOis «0.0.0.0... eee eeeeeeeeeeeeeeeeeeseaseteeeteeeees 612-944-0737 
NEW HAMPSHIRE 

Fk) 9 [0 = eee 603-888-8590 
OHIO 

IMASPSNASNCOs heise. ier dovrduinviiwauuisdevesers 216-447-1480 
OREGON 

POMEL Mecieueesetnetv airateusasctatnt Rca stented Aiettetens 503-274-6250 
PENNSYLVANIA 

FOES INGUIN oxi soe sscgcaesstecenwshav echaumasdocderionecsnecatdonss 215-784-0805 
TEXAS 

PRUSUU: acewecelunkdons Sees yc Gaede voebes ete cea ett fesse 512-343-8976 
DAIS sate ctere ca tatectlat Uevrase ned nea eh uaa acanseraneaes 214-987-9987 


© 1995 by Zilog, Inc. All rights reserved. No part of this document 
may be copied or reproduced in any form or by any means without 
the prior written consent of Zilog, Inc. The information in this 
documentis subject to change without notice. Devices sold by Zilog, 
Inc. are covered by warranty and patent indemnification provisions 
appearing in Zilog, Inc. Terms and Conditions of Sale only. Zilog, 
Inc. makes no warranty, express, statutory, implied or by descrip- 
tion, regarding the information set forth herein or regarding the 
freedom of the described devices from intellectual property infringe- 
ment. Zilog, Inc. makes no warranty of merchantability or fitness for 
any purpose. Zilog, Inc. shall not be responsible for any errors that 
may appear in this document. Zilog, Inc. makes no commitment to 
update or keep current the information contained in this document. 


INTERNATIONAL SALES OFFICES 


CANADA 

TOFORIO Sc csenslciseaecdenenaveheitvnasticaamlanenatuacumarbat 905-850-2377 

CHINA 

STC ZINC Nii2ds 5 favesen det speet vocedeca aatespaperameanals 86-755-2220869 
86-755-2220873 

SHANG Al saciairisi acs Acew sia eestani teen: 86-21-415-0691 
86-21-415-8158 

Rm. 5204 

GERMANY 

MUIPICHD sane ctecesias bdconnstesindsnsateaianelerecsel a catadecnns 49-8967-2045 

SOM Ol lab avin ice orsnies iste ioveiaucduntoarsetOamelwcites 49-3634-23906 

JAPAN 

TOKYO ck>, seaccceralsign cue nice tecenannatans 81-3-5272-0230 

HONG KONG 

IKGWIGOMT sieve eadssccnarsibeicndestaciioteinbadeerece®: 85-2-2723-8979 

KOREA 

SOOUl piss ssece cesses roduc evi dese emia 82-2-577-3272 

SINGAPORE 

VINQADOME sci siricacacnneanironeGaeaes 65-2357155 

TAIWAN 

PENDS 5 sean dsnareer ru eaevacadewneeonenetncemetniyuct Aes 886-2-741-3125 

UNITED KINGDOM 

Mal GENO ack vse issstavniittacracewiecs teas becaididacdanees 44-628-392-00 


Zilog's products are not authorized for use as critical components in 
life support devices or systems unless a specific written agreement 
pertaining to such intended use is executed between the customer 
and Zilog prior to use. Life support devices or systems are those 
which are intended for surgical implantation into the body, or which 
sustains life whose failure to perform, when properly used in accor- 
dance with instructions for use provided in the labeling, can be 
reasonably expected to result in significant injury to the user. 


Zilog, Inc. 210 East Hacienda Ave. 
Campbell, CA 95008-6600 
Telephone (408) 370-8000 

Telex 910-338-7621 

FAX 408 370-8056 

Internet: http:/Awww.zilog.com/zilog 














SALES REPRESENTATIVES AND DISTRIBUTORS 


U.S., CANADIAN & PUERTO RICAN 
REPRESENTATIVES 


ALABAMA 


Huntsville 
Alabama Bits, INC ................ccccsssssssseenerees (205) 534-4020 


ARIZONA 


Scottsdale 
Thom Luke Sales, INC. ...........ccccccceseeceeees (602) 451-5400 


CALIFORNIA 
irvine 
Infinity SAl@S ..... ce eesestessteseesstreseeeeees (714) 833-0300 
Santa Clara 
Phase Il Technical Sales... (408) 980-0414 
San Diego 
7X [0 |=] 11 See eRe en POPC OT nee Ren rece eee pee (619) 729-9216 


COLORADO 


Englewood 
Thorson Rocky Mountain ..........c.cccceceeee (303) 773-6300 


CONNECTICUT 


Wallingford 
Advanced Technical Sales .................. (508) 664-0888 


FLORIDA 


Altamonte Springs 
Semtronic Associates, INC. ..........cccccccees (407) 831-8233 


Clearwater 
Semtronic Associates, INC. ........cccceccceees (813) 461-4675 


Fort Lauderdale 
Semtronic Associates, INC. 0... eee (305) 731-2484 


GEORGIA 


Norcross 
Sf] ihc MR gk rot EROS mae OR TN RUIN SALMO (404) 564-5599 


ILLINOIS 


Hoffman Estates 
Victory Sales, INC. ...........c:cseseceeeesessrssnnes (708) 490-0300 


lOWA 


Cedar Rapids 
Advanced Technical Sales .................008 (319) 393-8280 


KANSAS 


Olathe 
Advanced Technical Sales .............c. (913) 782-8702 


MARYLAND 


Pasadena . 
Electronic Engineering & Sales................ (410) 255-9686 


MASSACHUSETTS 


North Reading 
Advanced Technical Sales ..............cc0 (508) 664-0888 


MICHIGAN 


Novi 
Rathsburg Associates, INC. ............:cee (810) 615-4000 


MINNESOTA 


Minneapolis 
Professional Sales for Industry................ (612) 944-8545 


MISSOURI 


Bridgeton 
Advanced Technical Sales ................6 (314) 291-5003 


NORTH CAROLINA 
Huntsville 
BTS) eaetecatabcess sven traccocantauseonesua alot (205) 881-2900 
Raleigh 
BBV: sessrvscucatieaecanveectsceeine tiene Anouaeusenains (919) 676-1880 


NEW JERSEY 


Cherry Hill 
TNO Sot rcedeetanracseltaahteigd ial ie cotinine n tees cease (609) 667-0200 


NEW MEXICO 


Albuquerque 
Quatra & Associates 0.0.0... eccesceseeceeees (505) 296-6781 


NEW YORK 
Fairport 
L-Mar Associates, INC. ..........ccccccceeeeees (716) 425-9100 


OHIO 


independence 
Rathsburg Associates, Inc. ................. (216) 447-8825 
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SALES REPRESENTATIVES AND DISTRIBUTORS 


OKLAHOMA 


Tulsa 
Nova Marketing, INC. ........cccccceeceeteeeeees (918) 660-5105 


OREGON 


Portland 
Phase Il Technical Sales...................8. (503) 643-6455 


TEXAS 
Austin 
Nova Marketing, INC. 0... cceeccccessseseeneees (512) 343-2321 
Dallas 
Nova Marketing, INC. ............ceeees (214) 265-4630 
Houston 
Nova Marketing, INC. ..............cceeeeeeeees (713) 240-6082 


UTAH 


Salt Lake City 
Thorson Rocky Mountain ............cc eee (801) 264-9665 


WASHINGTON 


Kirkland 
Phase II Technical Sales ........... ee (206) 821-8313 


WISCONSIN 


Brookfield 
Victory Sales, INC. woe cceeeeseeeeeeeees (414) 789-5770 


CANADA 
British Columbia 
J-Squared Technologies, Inc. ................ (604) 473-4666 
Ontario 
J-Squared Technologies, Inc. ................ (905) 672-2030 
Ottawa 
J-Squared Technologies, Inc. ................. (613) 592-9540 
Quebec 
J-Squared Technologies, INC. ............0006 (514) 694-8330 


PUERTO RICO 


Rio Piedras 
Semtronic Associates, INC. ................08 (809) 766-0700 
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SALES REPRESENTATIVES AND DISTRIBUTORS 


U.S. AND CANADIAN DISTRIBUTORS 


NATIONWIDE 
Newark Electronics ........ cc cceceecceeeeeeneeeee 1-800-367-3573 
ZEUS EI@CHFONICS 20.0... eee csecceescencesceeceaes 1-800-524-4735 
ALABAMA 
Birmingham 
Newark Electronics ............cccccccecceneeceeeees (205) 979-7003 
Huntsville 
Anthem Electronics ............ccccceeceecseeeee sees 208 890-0302 
Arrow EI@CHrOnicCs ........cccccccceeceeeceeseeeeeeeens 205) 837-6955 
Newark El@Ctronics ............ccccecceceeceeseeeees 205) 837-9091 
Mobile 
Newark EI@Ctronics ............cccccccecceeeeeeeees (205) 471-6500 
ARKANSAS 
Little Rock 
Newark Electronics ............ccecceeeeesceeeseeee (501) 225-8130 
ARIZONA 
Phoenix 
Anthem Electronics ............ccccceeeceseeeeeeeee 602) 966-6600 
Arrow Electronics .............cccccsssecesceeecen sees 202 431-0030 
Newark Electronics .......0.. cc ceeeeeceseeeeeeeeees 602) 864-9905 
Tempe 
Anthem Electronics ..........ccccccccecesseceeeseens (602) 966-6600 
Arrow Electronics ................ccccceueceeeeeeeeees BoD) 431-0030 
Newark Electronics ........... cee cccceesceeeeeeee 602) 966-6340 
CALIFORNIA 
Arcadia 
Newark Electronics .............::::ceeeeeeeeeeeeees (818) 445-1420 
Calabasas 
Arrow El@ctronics ............ccccceeeceeseeeeeereees (818) 880-9686 
Chatsworth 
Anthem Electronics ...........cccceccesecceseseeeees (818) 775-1333 
Chula Vista 
Newark Electronics 0.0.0... cceeeeeeeea ecco (619) 691-0141 
Fremont 
Arrow EI@Ctronics ...........ccecccsccceceeseneeeveess (510) 490-9477 
Garden Grove 
Newark Electronics ...........:cccesseeeceeaeeeeeees (714) 893-4909 
Hayward 
Arrow EI@CHronics .0........ccceeeceesseveeecceeneees (510) 487-8416 
irvine 
Anthem Electronics ...........ccceccceseceseeeneeees 4 768-4444 
Arrow EI@CHroniCs ............cececeeesececeseeseneves 714) 587-0404 
ZEUS EI@CtrONICS 0.2... cee cece eeeee eee seeeneeeeees 714) 581-4622 
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Palo Alto 

Newark Electronics .............ccccseeeeeeeeen (415) 812-6300 

Riverside 

Newark EI@ctronics ............ccccccesseceeeeees (909) 784-1101 

Sacramento 

Anthem Electronics .........cccccccesesssseeeeeens B16) 624-9744 

Newark EI@Ctronics ........ccccccccsccceceeeeeeeees 916) 565-1760 

San Diego 

Anthem EI@ctronics ...........ccccsesssereeeerees 619 453-9005 

Arrow EIectronicss ............ceceeeeseessesenees 619) 565-4800 

Newark El@Ctronics ........ccccsscccsecseceeeeees 619) 453-8211 

San Jose 

Anthem Electronics ...............cccccc cence 408) 453-1200 

Arrow EI@Ctronics ............cccccceseseceseeereeeens 408) 441-9700 

ZEUS EIOCHIONICS ..........cccccccceseessteseeeeeees 03 629-4789 

Santa Clara 

Newark Electronics ............ cc ceeeseeeeeseeeens (408) 988-7300 

Santa Fe Springs 

Newark ElectroniCs .......cccccsccsccseceeesseres (310) 929-9722 

Ventura 

Newark Electronics .0..... cc eeeeeeeeeeees (805) 644-2265 

West Hills 

Newark Electronics .............:ccccccceceeeseneees (818) 888-3718 
COLORADO 

Denver 

Newark Electronics ............cccceeeeeeee (303) 373-4540 

Englewood 

Anthem Electronics ........ cece 1303) 790-4500 

AIrOw EIGCHONICS sauces ince 303) 799-0258 
CONNECTICUT 

Bloomfield 

Newark Electronics ..........cccccceceeeseerees (203) 243-1731 

Norwalk 

ZEUS EIOCHIONICS 0... eeeeteeeeeeeeeee (203) 852-5411 

Wallingford 

Arrow EIe@ctronics .............cccceseeseeseseeeeeeens (203) 265-7741 

Waterbury 

Anthem Electronics ..............cccceesessneeeeees (203) 575-1575 





SALES REPRESENTATIVES AND DISTRIBUTORS 


FLORIDA 
Altamonte Springs 


Anthem Electronics 
Clearwater 
Anthem Electronics 


Fort Lauderdale 
Anthem Electronics 
Deerfield Beach 


Arrow Electronics ... 


Jacksonville 
Newark Electronics 
Orlando 

Newark Electronics 
Plantation 

Newark Electronics 
Tampa 

Newark Electronics 
Lake Mary 


Arrow Electronics ... 


Zeus Electronics 


GEORGIA 


Duluth 
Anthem Electronics 


Arrow Electronics ... 


Norcross 
Newark Electronics 


IDAHO 


Boise 
Newark Electronics 


ILLINOIS 

Addison 

Newark Electronics 
Arlington Heights 
Newark Electronics 
ltasca 


Arrow Electronics ... 


Zeus Electronics 
Rockford 
Newark Electronics 
Schaumberg 
Anthem Electronics 
Newark Electronics 
Springfield 
Newark Electronics 
Willowbrook 
Newark Electronics 


Pere eee eta (407) 831-0007 


sae karat die rac eee addeas (813) 538-4157 
(800) 359-3522 


se Mecseeeesee tread casted (305) 484-0990 
eee (305) 429-8200 
ee ee (904) 399-5041 
eer eee (407) 896-8350 
a eye (305) 424-4400 
ne oer eres (813) 287-1578 


Beep aiiioner ta aaeepeetacinees i407) 333-9300 
407) 333-3055 


eee eee eee ee eee eee eee ee 


800) 293-0023 


beuteieed biesshe tutta nGse sa) 931-3900 
404) 497-1300 


eee eee eee eee ee ee 


Poseistadetpeaseanectaes (404) 448-1300 
sudo eeaeeank (208) 342-4311 


Siete te eel a (708) 495-7740 
Sees ae (708) 956-9270 


et ie +O) 250-0500 
708) 595-9730 


Shi SA tebe aot A (815) 229-0225 


seve totus conan eaten 708) 884-0200 
708) 310-8980 


ole etiaaee aes (217) 787-9972 


nase daancteaepereetaeatne tuna OR 789-4780 
708) 654-8250 


INDIANA 

Ft. Wayne 

Newark Electronics ..........ccc:ccceseseseeeeeenes (219) 484-0766 

Indianopolis 

Arrow EI@Ctronics ............cccccessscesseseneeecees 317) 299-2071 

Newark Electronics ............ccccceccecseeneeees af Sear 
IOWA 

Bettendorf 

Newark Electronics ..........:cccceseeseneceeeees (319) 359-3711 

Cedar Rapids 

Arrow Electronics .0..........cccccccseeseseeseeenes 319) 395-7230 

Newark Electronics .............ccccecceceeeeeeees 319) 393-3800 

West Des Moines 

Newark Electronics ...............ccccecceceeeeeeees (515) 222-0700 
KANSAS 

Lenexa 

Anthem Electronics .........ccccccceseceesseeeeeees 913) 599-1528 

Arrow EI@Ctronics ...........ccccceeeceseseseeeeeees 913) 541-9542 

Overland Park 

Newark Electronics ........0......ccceesseeseeee eee (913) 677-0727 
KENTUCKY 

Louisville 

Newark Electronics .............cccceseseecseeeeeees (502) 423-0280 
LOUISIANA 

Metarie 

Newark EI@CtroniCs ........cccesesseseeeeeeeees (504) 838-9771 
MARYLAND 

Columbia 

Anthem Electronics ..............ccccccceeseeeeeees 410) 995-6640 

Arrow EI@Ctronics ...........ccccceeccecceeeereeeeeees 410) 596-7800 

Hanover 

Newark Electronics ......c cc ccssseseteeeerees (410) 712-6922 
MASSACHUSETTS 

North Reading — 

Advanced Technical Sales .................04. (508) 664-0888 

Marlborough . 

Newark El@ctronics ............cccccecseseeeeeeeees (508) 229-2200 

Methuen 

Newark Electronics ..................cccceeseee eee (508) 683-0913 

Wilmington 

Anthem Electronics ....................cccccccceeees 508) 657-5170 

Arrow EI@CtroniCs ...........ccccseseeesesseeseeeeeees 508) 658-0900 

ZEUS EI@CTtIONICS 0.0.0.0... eeeeeeccceeeeeeee eens 508) 658-4776 

Woburn 

Newark EI@ctronics .............ccecceseseceeeteees (617) 935-8350 








SALES REPRESENTATIVES AND DISTRIBUTORS 


U.S. AND CANADIAN DISTRIBUTORS 
MICHIGAN 


Grand Rapids 

Newark Electronics .............cccccssesseseeeerees (616) 954-6700 

Livonia 

Anthem Electronics .............:ccsecscesenenes 209 347-4090 

800) 359-3526 

Arrow Electronics ................:ccssceceseseeeeeees 313) 462-2290 

Oak Park 

Newark Electronics ...........:cccccccceeeseeeeeees B10) 967-0600 

810) 968-2950 

Plymouth 

Arrow El@ctronicss .............ccccceeeeeseeeseeeeeees (313) 462-2290 

Saginaw 

Newark Electronics ........cccseseeereeeees (517) 799-0480 
MINNESOTA 

Eden Prairie 

Anthem Electronics ............cccceeeseeeeeee 1813) 946-4826 

Arrow Electronics ................0.ccccceeseeesereees 612) 941-5280 

Minneapolis 

Newark Electronics .........ccccecceceeeneeeeeees (612) 331-6350 

St. Paul 

Newark Electronics ............ccccceeseerereeeees (612) 631-2683 
MISSISSIPPI 

Ridgeland 

Newark Electronics ...........cccecccsseeeeenes (601) 956-3834 
MISSOURI 

Maryland Heights 

Newark EleCtroniCs ..........cccceccececereeeeeees (314) 298-2505 

St. Louis 

Arrow EI@Ctronics .........cccccccsesseeesessreeseeess (314) 567-6888 


MONTANA 


Helena 
Newark Electronics 0.0.0... cececeeeeeeeee (406) 443-6192 


NEBRASKA 


Omaha 
Newark Electronics .............ccccceeeeeeeeeeeeee (402) 592-2423 


NEVADA 
Las Vegas 
Newark Electronics ............cccccceeeeseeereeeees (702) 597-0330 
Reno 
Newark Electronics ...........ccccceccecceseeeeeeee (702) 322-6090 
Sparks 
Arrow EI@Ctronics ............cccccccceeececeeeeeeeees (702) 331-5000 


NEW HAMPSHIRE 


Nashua 
Newark Electronics ..........ceecceeseeeeeeees (603) 888-5790 


NEW JERSEY 
East Brunswick 
Newark Electronics .......... cc ccccesscseceeeeeees (908) 937-6600 
Marlton 
Arrow Electronics ..............cccccececeeeeneeeeeee (609) 596-8000 
Pinebrook 


Anthem Electronics .........ccccceeseccsscnecenes ea 227-7960 
Arrow Electronics ...........cccceeccccceeceeeeeeseees 201) 227-7880 


Union 
Newark Electronics ...........c...cccesecceeeeeeeees (908) 851-2290 





SALES REPRESENTATIVES AND DISTRIBUTORS 


NEW MEXICO 
Albuquerque 
Newark Electronics ...............:ccccccsseseeees (505) 828-1878 
NEW YORK 
Bohemia 
Newark Electronics ..............cccccceseeeeseueeee (516) 567-4200 
Brookhaven 
Arrow EI@ctronics ...........ccccccsececcreereeeeeees (516) 924-9400 
Cheektowaga 
Newark Electronics ..........cccccccccsesseseeseeees (716) 862-9700 
Commack 
Anthem Electronics ..............ccccsseeeeeeeeeens (516) 864-6600 
Hauppauge 
Arrow EI@Ctronics ............ccccceecccsecccnceeenees (516) 231-1000 
Latham 
Newark Electronics ..........cceeccceeseeeeceescoeee (518) 783-0983 
Liverpool 
Newark Electronics ...............ccccccccesceeenees (315) 457-4873 
Long Island 
Anthem Electronics ...........ccccccccecceceeeeees (516) 864-6600 
Melville 
Arrow EI@Ctronics ...........::ccsesssececseeessseees (516) 391-1300 
Rochester 
Arrow Electronics ............cecccceseseeeseeeeeeeees (716) 427-0300 
Pittsford 
Newark Electronics ...............cccccssseeeseeeen (716) 381-4244 
Port Chester 
ZEUS EISCHIONICS 00.0... ee eeecceceeeveneeeesenens (914) 937-7400 
Wappingers Falls 
Newark Electronics ...........:cceseesssseseeeeeees (914) 298-2810 
NORTH CAROLINA 
Charlotte 
Newark Electronics ................ccccccsecceeceees (704) 535-5650 
Greensboro 
Newark Electronics ...........cccccsssseseeeeeeees (910) 294-2142 
Raleigh 
Anthem Electronics .............ccccccceeceseceeuees 919) 782-3550 
800) 359-3532 
Arrow EI@Ctronics .............cccccceeseeeseceseeeees Bs 876-3132 
Newark Electronics ...............seseesseeessevens 919) 781-7677 


OHIO 

Centerville 

Arrow Electronics .............ccccceeesseseeseeeseeee (513) 435-5563 

Cincinnati 

Newark EI@CtroniCs ..........ccsessssceeeeeseces (513) 772-8181 

Cleveland 

Newark Electronics ...........:ccccccsseeeseeeeees (216) 391-9330 

Columbus 

Newark Electronics ........ cc eeeccseseneees (614) 326-0352 

Dayton 

Newark Electronics ............. cc ceceeseeseveees (513) 294-8980 

Solon 

Arrow Electronics ............0cccccceseessreessereees (216) 248-3990 

Toledo 

Newark Electronics ............cccccccseeeeeseeeees (419) 866-0404 

Youngstown 

Newark Electronics ..............0:ccccceeseeeeees (216) 793-6134 
OKLAHOMA 

Oklahoma City 

Newark Electronics .............cccscccsseesssees (405) 843-3301 

Tulsa 

Arrow EI@Ctronics ........... cee eeeeeeeneeneeeeeees 318) 252-7537 

Newark Electronics ...........ccceececeereeeceees 918) 252-5070 
OREGON 

Beaverton 

ALMAC/Arrow Electronics .......... cesses +203) 629-8090 

Anthem Electronics .........ccccccccsseneeeeeees 503) 643-1114 

Portland 

Newark Electronics ............::c:cscccessreenees (503) 297-1984 
PENNSYLVANIA 

Allentown 

Newark Electronics ...........ccccsseeeeeeteees (610) 434-7171 

Fort Washington 

Newark Electronics ...............ccecceeeceeeeeees (215) 654-1434 

Horsham 

Anthem Electronics ............cccccccccsesseeeeeees (215) 443-5150 

Pittsburgh 

Arrow EI@CHrOniCs .......ccceceseeesseeeteeseees i413} 856-9490 

Newark El@Ctronics ..........ccecsceeeeeeeees 412) 788-4790 
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SALES REPRESENTATIVES AND DISTRIBUTORS 


U.S. AND CANADIAN DISTRIBUTORS 


SOUTH CAROLINA 

Greenville 

Newark Electronics ............ccccccccceeeeeeees (803) 288-9610 
TENNESSEE 

Brentwood 

Newark Electronics ...........cccccesecceceeeeseeeee (615) 371-1341 

Knoxville 

Newark EI@Ctronics ........cccccccceeceseeeeeees (615) 588-6493 

Memphis 

Arrow EI@Ctronics ..........ccceccessecseccueeeesesees (30) 367-0540 

Newark El@Ctronics ..........cccccecccseeceseeseeees 901) 396-7970 
TEXAS 

Austin 

Anthem Electronics ............ccccececccceseesesees 512) 388-0049 

Arrow EI@Ctronics ...........ccccccceeccseeeesessaeees SI _ 835-4180 

Newark EI@Ctronics ..........cccccesseeeeessereesens 512) 338-0287 

Carrollton 

Arrow EI@Ctronics ........:.ccsscecscersesereveceesees ea 4 380-9049 

ZOUS ELSCHONICS s.5.cssscessncusascecasversnisinasaat 214) 380-4330 

Corpus Christi 

Newark Electronics ..........cccccccecseceseesenees (512) 857-5621 

Dallas 

Newark Electronics ..............c.ccccccceseeeeeees (214) 458-2528 

El Paso 

Newark Electronics .......cccceccecceseeseseerenees (915) 772-6367 

Houston 

Arrow EI@Ctronics ...........cceeecsesessecseseeeeeees a 3 647-6868 

Newark EI@Ctronics ...........cccceseseecesseeseeees 713) 894-9334 

Richardson 

Anthem Electronics .............:0cceeeeeeeee (214) 238-7100 

San Antonio 

Newark Electronics .............ccccceeeeeeeeeeees (210) 734-7960 
UTAH 

Salt Lake City 

Anthem Electronics .........0..ccccceeceeseeeeeees 801) 973-8555 

Arrow Electronics ...........cceceeseeees ei mnioos 201 973-6913 

Newark Electronics ......... ec ceeeeeeeeceeeneee 801) 261-5660 
VIRGINIA 

Herndon 

Newark EI@ctronics .......ccccccsceccccceseeeeeeeees (703) 707-9010 

Richmond 

Newark EI@ctronics .........ccccecceseseaseeees (804) 282-567 1 

Roanoke 

Newark Electronics .0... ce eeecseeeeeees (703) 772-6821 
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WASHINGTON 
Bellevue 
ALMAC/Arrow Electronics ...................008 206) 643-9992 
Newark Electronics ............cccecceeeceeeseeeeees 206) 641-9800 
Bothell 
Anthem Electronics ...........cccsesssrsscesreeens (206) 483-1700 
Spokane 
ALMAC/Arrow Electronics ............ccccc0e 509) 924-9500 
Newark Electronics .............cc.cccceceseeseeees 509) 327-1935 
WEST VIRGINIA 
Charleston 
Newark Electronics ..........ccccccceeeseceeneees (304) 345-3086 
WISCONSIN 
Brookfield 
Arrow Electronics .00........ccccceessseeeeseeenes (414) 792-0150 
Green Bay 
Newark Electronics ...........ccccccceeesseeeens (414) 494-1400 
Madison 
Newark Electronics ..........ccseseeeeseeeceseeens (608) 221-4738 
Milwaukee 
Newark EI@Ctronics ...........cccsesseeesceeenees (414) 453-9100 
CANADA 
Alberta 
Future Electronics ............ccccccceeeseeeeeeeeeee 403) 250-5550 
Future Electronics ........ccccccecccssecsesseeseeeeee 403) 438-2858 
British Columbia 
Arrow EI@CtrOniCs ..........cceccecceescesseeececeeens 604) 421-2333 
Future Electronics ............cce eee eeeeceeseeeeeee 604) 294-1166 
Manitoba 
Future El@Ctronics ............ccccceceeeeeeeeseeeeees (204) 944-1446 
Montreal 
Arrow EI@Ctronics ..........ccccseccccseececeeceaseens P14 421-7411 
Future El@Ctronics .........ccccceesesescsecceseeesens 514) 694-7710 
Ontario 
Arrow Electronics .............ccccceeeeeseceeee seers 613) 226-6903 
Arrow EI@Ctronics ..........ccccceececceeeeeseseeueees 905) 670-7769 
Future El@Ctronics ...........cccecsesceececeeceeeeess 905) 612-9200 
Future Electronics .0..........c.c cece ceeeeeeseeeeeee 613) 820-8313 
Newark Electronics ...........cccc ee eeee scene 519) 685-4280 
Newark Electronics ...........cccsecsecseeceesseeess 905) 670-2888 
Toronto 
Arrow EI@Ctronics ..........ccscsessccccrereeseeeeees (416) 670-2010 
Quebec 
Arrow Electronics 2.0.0.0... eeeeeeceee secon ees 418) 871-7500 
Future Electronics 2.0.0.0... ee eeeeceese sevens 418) 877-6666 
Newark Electronics ...........:c...cccseceeeseeeeees 514) 738-4488 





SALES REPRESENTATIVES AND DISTRIBUTORS 


CENTRAL AND SOUTH AMERICA 


MEXICO 

Semiconductores 

ProfeSiOnales ...........c.cccccceccesceceeceeceuscuseneees 525-524-6123 
ARGENTINA 

Buenos Aires 

cal a | ae eee oe ee ere 011-541-440-1532 
ASIA-PACIFIC 
AUSTRALIA 

R&D Electronics ............ccecceeccueceeeeeeeeeeeaees 61-3-558-0444 

GEC Electronics Division ..............0..0..0.. 61-2-638-1888 
CHINA 

Beijing 

China Electronics Appliance Corp. ...... 86-755-335-4214 

TLG Electronics, Ltd. oo... eee 85-2-388-7613 
HONG KONG 

Electrocon Products, Ltd. ........00. ee. 85-2-481-6022 

Components Agent, Ltd... 85-2-487-8826 

Maxisum, Ltd. oo... eee ceccececsesceneesennecene 85-2-410-2780 

MEMEG, (EUG a scotns cence cater copiconaiatetacnenkied 85-2-410-2777 
INDIA 

Bangalore 

WAXV GO aie icin reramcneaersare ne ate decenniacteatiles 91-80-556-6761 

Zenith Technologies Pvt. Ltd. ............08. 91-80-558-6782 

Bombay 

Zenith Technologies Pvt. Ltd. ............. 91-22-494-7457 

DEVS basis re lovicitec ota taeda daeteniacehaicetes 91-22-830-0959 

New Delhi 

Maxvale (S) Pte. Ltd... eeecceececeeeeees 91-11-622-5122 
INDONESIA 

Jakarta 

Cinergi ASIAMAYU .........c cece ceeeeeceeseeeeeseeeeees 62-2 1-7982762 
JAPAN 

Tokyo 

POKSC) CO cs 1G) ice ceontavldates cance tint: 81-3-5467-9000 

Internix Incorporated ..0.. eee eece eee ee 81-3-3369-1105 

Kanematsu Elec. Components Corp. ..... 81-3-3779-781 1 

Osaka 

TEKSCl GO cM oiiiciseuducseaptavcesemateaeie ene. 81-6368-9000 


BRAZIL 
Sao Paulo 
NISHIGOM ocd ecoscnonssaeeadsds daveaeeiens 011-55-11-535-1755 
CSPAIE GC ieeshecice ds erst eid nla stedeeoteeea 011-572-2727 
DSD Microtechnology Distributors ............ 305-563-8665 
KOREA 
BING Oled a anteisse otis eet hat needa loanet 822-523-2220 
MEMEG HtGe veccecn ce Serutaenccteaednmsuansent 822-518-8181 
MALAYSIA 
KRisala LUMP OF ince Aichoitectstioreiauseban 60-3-703-8498 
Penang L.1. Electronics Ltd. 0.0.0.0... 60-4-656-2895 
NEW ZEALAND 
GEC Electronics Division ...........00.. ee. 64-9-526-0107 
- PHILIPPINES 
Alexan Commercial .........ccccccccseeesceeeeeeunens 63-2-241-9493 
Cinergi Tech & Devices (Phils), Inc. ........ 63-2-8 17-9519 
SINGAPORE 
Aad penny & Devices Pte. Ltd. ..... 65-778-9331 
Eltee Electronics Ltd. oo. ceeee eens 65-283-0888 
MEMEG, Ut: sii ccc surwsessilnsdaetcisonecceeleteadens 65-222-4962 
TAIWAN (ROC) 
Acer Sertek, INC. ......cccceccccecccceececeeneesesees 886-2-50 1-0055 
Asec Int'l. Corporation ..............cc cee 886-2-786-6677 
MEMEG, Lids svcciscsssiaciaesodcnenceehdecses ta eedile 886-2-760-2028 
Promate Electronics Co. Ltd. .........00.00... 886-2-659-0303 
THAILAND 
Eltee Electronics Ltd. oo... ecceecseeeeeeeee 66-2-933-7565 

















SALES REPRESENTATIVES AND DISTRIBUTORS 


EUROPE 
AUSTRIA 

Vienna 

EBV Elektronik GMBH ...............cee ee 43-222-8941-774 

Avnet/Electronic 2000 ...............:ccceeceees 0043-1-91 12847 
BELGIUM 

Antwerp 

D & D Electronics PVBA............cc cece eeee ee 32-3-8277934 

Zaventem 

EBV El@Ktronik asi ssvicdecctsancdiscesivdesdenetectvanvects 322-7209936 
DENMARK 

Brondby 

Ditz Schweitzer AS ..........cccececececessseseceeeee wees 4542-453044 

Lynge 

POD DGICO yiicdcstetsceaseceivetaareeescnareneeaee 45-35-821200 
ENGLAND 

Berkshire 

Future Electronics .............ccsescccsesseeseueeees 44-753-521193 

GOTHIC Crellon ica cccctaiesivesdetsdidecaaves 44-734-787848 

Macro Marketing .......ccccccceeesseessesseneeees 44-628-604383 

Kent 

Arrow EI@Ctronics ........ccccccccssesseseeeessenseeeees 44-732-74039 

Lancashire 

Complementary Technologies Ltd. ......... 44-942-274731 
FINLAND 

Espoo 

YVleiselektroniikka ..........cccssecssessceeeeseseeeseees 358-0-452-621 
FRANCE 

Cedex 

PRON urs ehinttac ebevadatisian tn uy dette ees etnpasun’ 331-395-49-113 

CCL -EISCHOMIQUS sii tecsnssesch csssatedovetvetientens 331-46744700 

Champs sur Marne 

EBV ElSKinOnik isccicutcorcicecnteover usenet 331-646-88600 

Massy 

REDIONIC SA csscsenccsiwss ehssastesacrsessameataseens 33 1-60139300 


GERMANY 
Berlin 
EBV Elektronik GMBH ..............ccccceeeeeeeeeesees 030-3421041 
Avnet/Electronic 2000 .0........ cc eeeeeseseeseeeeeees 030-2110761 
Burgwedel 
EBV Elektronik GMBH ..............cccccccsseeceseeres 05139-80870 
Camberg 
TRESVS:AIE sade ii Spsberdaistea Caen bee 49-6434-5041 
Castrop 
Future GMBH ....... cece eccceecsesseceeeeceeeeene anes 02305-4205 1 
Dortmund 
Future GMBH ...................cc..cccscsecvseeesseceenes 02305-4205 1 
Duesseldorf 
Avnet/Electronic 2000 .........ccccessecsseenees 021 1-9200385 
THESV SIAC sseciics cuscsnsse du eeeeusirer cant vais canes 0211-536020 
Erfurt 
TAOSVS icccntcinot a eetindadieind: 0361-4278100 
Erkrath 
Avnet/Electronic 2000 .............ccccesecceeeseeees 211-92003-85 
Frankfurt 
EBV Elektronik GMBH ........ccc ce eeeeeeees 069-785037 
Avnet/Electronic 2000 ......ccccccccccceeeeseeees 069-973804 1 
Future GMBH .......... cc cccccccssecesseseeseeesecuseveeees 06121-54020 
TheSYS/AE .......... ccc cecccceesesseeccecesessteeeeeeeeeeeesaas 06434-5041 
Gerlingen 
Avnet/Electronic 2000 .......0.... eee 7156-356190 
Hamburg 
Avnet/Electronic 2000 ........eceesssseeseeseeees 040-64557021 
Leonberg 
EBV Elektronik GMBH ............... cee 07152-30090 
Muenchen 
Avnet/Electronic 2000 0.0... ccccccseseecseeeeeees 089-451 1004 
EBV Elektronik GMBH ..............0....c. eens 089-456 100 
Future GMBH .........ccc ccc ceccceeceseeseeseeecceeeeeseenees 089-957270 
THESYS AVE wittcavtecca)tatcscne aecaaes 89-99355866 
Nuernberg 
Avnet/Electronic 2000 0.0.0... eeeceeeeeseeseeees 0911-9951610 
Neuss 
EBV Elektronik GMBH ............... cece 02131-96770 
Quickborn 
Future GMBH ........ cc eecccccsccccsecsessseeseceecseasens 4106-71022 
Rauxel 
Future GMBH ...0........  ecccssccsesssseeesseasscesees 02305-42051 
Stuttgart 
Avnet/Electronic 2000 uu... cceececceseeee eens 07 156-356 190 
PUtUTS GMB cases eee siorertortlenentieniata: 0711-830380 
TRESVS/AE sscolassisidesdachaeienseslaveseacrevuced! 07 11-9889100 
Weissbach 
EBV Elektronik GMBH ..............00.cccccceeee eee eeees 036-426486 
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SALES REPRESENTATIVES AND DISTRIBUTORS 


ISRAEL 

2B ee reece ene are re me ern rete Ore eR Dem Oy 972-35483137 
ITALY 

Milano 

Avnet EMG S.R.L. wc eeeeeseeseseeeeene 0039-295-343600 

EBV Elektronik ...........ccceececccssesseeeeseevens 0039-2-66017111 

Silver Star oo... cece cece ce eeeseeeeeseeeeeeesseees 02-66-125-1 

Firenze 

EBV Elektronik ...........0.0.ccccccccsssoscvsseeeeee 0039-55-350792 

Roma 

EBV Elektronik .0.......c cece eeeecccsseeeeeseeee ees 0039-6-2253367 

Modena 

EBV Elektronik ..........ccccccceccesccesseesseseseens 0039-59-344752 

Napoli 

EBV Elektronik ..........cccccccsececcsccseeseeeeecs 0039-8 1-2395540 

Torino 

EBV Elektronik .......0000cccccccccecseseeeeeseeaee 0039-1 1-2161531 
NETHERLANDS 

EBV Elektronik 200.0... ceeeccccceseeseceeeeeees 313-465-2353 
NORWAY 

BEXaD NOG wiisicicsten ta nmadinacaluoonnons 47-63833800 
POLAND 

Warsaw 

GINA Asie ioscnt ocsSauaetciadelansantsiananens 004822-330853 
PORTUGAL 

Amadora 

AMitrOn-Arrow., .......cccccecececseesseeeneeesseueees 0035-1-4714806 


RUSSIA 
Woronesh 
TheSYS/INTECHIA 0... cccessesccseesecsentrtetteaseneas 0732553697 
Vyborg 
Gatina Ui vase ialias cenaiatnmeanenes. 81278-31509 
St. Petersburg 
GAIA GS eet incetaadectteceseninaiaovedetautedesiys 812-5311402 


SPAIN 
Barcelona 
Amitron-Arrow S.A. ........c.ccccccscceeseeceeaeens 0034-3-4907494 


Madrid 
Amitron-Arrow S.A. .....cccccccccceesescrsceeececes 0034-1-3043040 . 


SWEDEN 
Bexab Sweden AB ..........cccccccesssssessrseeeeees 46-8-63088-00 
Rep Delco Sweden AB ...........::ccesseceereees 46-8-63086-00 


SWITZERLAND 


Dietikon 
EBV Elektronik GMBH ...................0..008 0041-1-7401090 


Lausanne 

EBV Elektronik AG wu... ceesessene ees 0041-21-3112804 
Regensdorf 

EULOGIS AG ia ccicac teste eatsttessaanseetn veer 0041-1-8433111 


UKRAINE 


Kiev 
ThesySs/Mikropribor ............ cc ceeeeeeteteees 44-434-9533 
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A SiLas LITERATURE GUIDE 


Z8® MICROCONTROLLERS - CONSUMER FAMILY OF PRODUCTS 
Databooks By Market Niche Part No Unit Cost 


Z8® Microcontrollers Databook DC-8305-03 $ 5.00 
Product Specifications 
Z286B07 CMOS Z8 8-Bit MCU for Battery Charging and Monitoring 
286C05/C07 CMOS Z8 8-Bit Microcontroller 
Z86E07 CMOS Z8 8-Bit OTP Microcontroller 
786011 CMOS Z8 Microcontroller 
286012 CMOS Z8 In-Circuit Microcontroller Emulator 
Z86C21 8K ROM Z8 CMOS Microcontroller 
Z86E21 CMOS Z8 8K OTP Microcontroller 
286C61/62/96 CMOS Z8 Microcontrollers 
Z86E61/63 16K/32K EPROM CMOS Z8 Microcontrollers 
286C63/64 32K ROM Z8 CMOS Microcontrollers 
286091 CMOS Z8 ROMless Microcontroller 
286093 CMOS Z8 Multiply/Divide Microcontroller 
286117/717 Z8 8-Bit CMOS OTP/ROM Microcontrollers 


Application Notes 
On-Chip Oscillator Design 
Designing a Low-Cost Thermal Printer 


Support Product Specifications 
Z0860000ZC0 Evaluation Board 
Z86C1200ZEM Emulator 
Z86E0700ZDP Adaptor Kit 
Z86E2100ZDF Adaptor Kit 
Z86E2100ZDP Adaptor Kit 
Z86E2100ZDV Adaptor Kit 
Z86E2101ZDP Adaptor Kit 
Z86E2101ZDV Adaptor Kit 
Z86C6100TSC Emulator 
786C6200ZEM Emulator 
286093007EM Emulator 
Z8 S Series Emulators, Base Units and Pods 


Additional Information 
Zilog's Superintegration™ Products Guide 
General Terms and Conditions of Sale 
Zilog's Sales Offices, Representatives and Distributors 
Literature Guide & Third Party Support Vendors 








QZLCS _—_LITERATURE GUIDE 


Z8® MICROCONTROLLERS - CONSUMER FAMILY OF PRODUCTS 
Databooks By Market Niche Part No Unit Cost 


Infrared Remote (IR) Controllers Databook DC-8301-04 $ 5.00 
Product Specifications 
Z86L03/L06 Low Voltage CMOS Consumer Controller Processor 
Z86L29 6K Infrared (IR) Remote (ZIRC™) Controller 
Z86L70/L71/L72/L75/L76 Zilog fF (ZIRC™) CCP™ Controller Family 
Z86L73/74/77 24/32K ROM Infrared Remote Controller (ZIRC™) 
Z86E72/E73/E74/77 Zilog IR (ZIRC™) CCP™ Controller Family 
286C72/76 Zilog Infrared Remote Controller Family (ZIRC™) 
Z86L78 16K, 20-Pin Zilog Infrared Remote Controller (ZIRC™) 


Application Note 
Beyond the 3 Volt Limit 
X-10 Compatible Infrared Remote Control 


Support Product Specifications 
Z86C50000ZEM Emulator 
286L7100ZDB Emulator Board 
Z86L7100ZEM ICEBOX™ In-Circuit Emulator Board 


Additional Information 
Zilog's Superintegration™ Products Guide 
Literature Ordering Guide 
Zilog's Sales Offices, Representatives and Distributors 
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Z8® MICROCONTROLLERS - CONSUMER FAMILY OF PRODUCTS 
Databooks By Market Niche 


Discrete Z8° Microcontrollers 
Product Specifications 

Z86C03/C06 CMOS Z8® 8-Bit Consumer Controller Processors 
Z86E03/E06 CMOS Z8® 8-Bit OTP Consumer Controller Processors 
Z86C04/C08 CMOS Z8® 8-Bit Low Cost 1K/2K ROM Microcontrollers 
Z86E04/E08 CMOS Z8® 8-Bit OTP Microcontrollers 
Z86C07 CMOS Z8® 8-Bit Microcontroller 
Z86E07 CMOS Z8® 8-Bit OTP Microcontroller 
Z86C30/C31 CMOS Z8® 8-Bit Consumer Coniroller Processors 
Z86E30/E31 CMOS Z8® 8-Bit OTP Consumer Controller Processors 
Z86C40 CMOS Z8® 4K ROM Consumer Controller Processor 
Z86E40 CMOS Z8® 8-Bit OTP Consumer Controller Processor 


Z8® Microcontrollers Application Notes 
Timekeeping with the Z8® 
Using The Zilog Z86C06 SPI Bus 
DTMF Tone Generation Using the Z8® CCP™ 
Serial Communications Using the Z8® CCP™ Software UART 
The Versatile Z86C08: Three Key Features of this Z8® MCU 
The Z86C08 Controls a Scrolling LED Message Display 
Interfacing LCDs to the Z8® Microcontroller 


Support Product Specifications and Third-Party Vendors 
Z86C0800ZC0 Evaluation Board 
Z86C0800ZDP Adaptor Kit 
286C1200ZEM Emulator 
Z86E0600ZDP Adaptor Kit 
Z86E0700ZDP Adaptor Kit 
Z86E3000ZDP Adaptor Kit 
Z86E4000ZDF Adaptor Kit 
Z86E4000ZDP Adaptor Kit 
Z86E4000ZDV Adaptor Kit 
Z86E4001ZDF Adaptor Kit 
Z86E4001ZDV Adaptor Kit 
Z86CCPOOZEM Emualtor 
Z86CCPOOZAC Emulator Kit 
Z8®S Series Emulators, Base Units and Pods 
Third-Party Support Vendors 


Additional Information 
Zilog's Superintegration™ Products Guide 
Literature Guide and Ordering Information 
Zilog's Sales Offices, Representatives and Distributors 


Part No 
DC 8318-02 


Unit Cost 
$ 5.00 
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Q2LOS  _—_LITERATURE GUIDE 


Z8® MICROCONTROLLERS - CONSUMER FAMILY OF PRODUCTS 
Databooks By Market Niche Part No 


Digital Television Controllers DC-8308-01 
Product Specifications 
789300 Series Digital Television Controller 
Z86627/97 CMOS Z8® Digital Signal Processor 
786047/E47 CMOS Z8® Digital Signal Processor 
286127 Low Cost Digital Television Controller 
786128/228 Line 21 Closed-Ca tat Controller (L21C™) 
786227 40-Pin Low Cost (4LDTC™) Digital Television Controller 
Support Product Srocifcarions 
Z86C2700ZC0 Application Kit 
Z86C2700ZDB Emulation Board 
286C2702ZEM In-Circuit Emulator 
Additional Information 
Zilog's Superintegration™ Products Guide 
Literature Guide and Ordering Information 
Zilog's Sales Offices, Representatives and Distributors 


Telephone Answering Device Databook DC-8300-03 
Product Specifications 
Z89165/166 (ROMless) Low-Cost DTAD Controller (Preliminary) 
789167/169 289168 (ROMless) Enhanced Dual Processor Tapeless TAM Controller (Preliminary) 
Development Guides 
789165 Software Developer's Manual 
289167/169 Software Developer's Manual 
Technical Notes 
289165/167/169 Design Guidelines 
289167/169 Codec Interfacing Preliminary 
Controliing the Out -5V and Codec Clock Signals for Low-Power Halt Mode 
289165/166 Input A/D and Electronic Hybrid 
289C67/C69/167/169 Low-Power Halt Mode Sequence 
Samsung KT8554 Codec 
Watch-Dog Timer For TAD Applications 
Zilog LPC Words Listing 
Support Product Specifications 
Z89C5900ZEM Emulation Module 
Z89C6500ZDB Emulation Board 
289C6501ZEM ICEBOX™ In-Circuit Emulator 
289C6700ZDB Emulator Board 
Z89C6700ZEM ICEBOX™ Emulator Board 
Additional Information 
Zilog's Superintegration™ Products Guide 
Literature Ordering Guide 
Zilog's Sales Offices, Representatives and Distributors 


Unit Cost 
$ 5.00 


$ 5.00 
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A SILAS LITERATURE GUIDE 


Z8® MICROCONTROLLERS - PERIPHERALS MULTIMEDIA FAMILY OF PRODUCTS 





Databooks By Market Niche Part No Unit Cost 
Digital Signal Processors Databook DB95DSP0105 $ 5.00 
Product Specification 
289321/371/391 16-Bit Digital Signal Processor 
Application Notes 


Using the Z89321/371/391 CODEC Interface 

289321/371/391 Interprocessor Communication 
Support Product Specification 

28937100ZEM ICEBOX™ In-Circuit Emulator -371 
Additional information 

General Terms and Conditions of Sale 

Zilog's Sales Offices, Representatives and Distributors 

Literature Guide and Ordering Information 


Keyboard/Mouse/Pointing Devices Databook DC-8304-01 $ 5.00 


Product Specifications 
28602/14 NMOS Z8® 8-Bit Keyboard Controller 
78615 NMOS Z8® 8-Bit Keyboard Controller 
286015 CMOS Z8® 8-Bit MCU Keyboard Controller 
Z86E23 Z8® 8-Bit Keyboard Controller with 8K OTP 
286004/C08 CMOS Z8® 8-Bit Microcontroller 
Z86E08 CMOS Z8® 8-Bit Microcontroller 
288017 CMOS Z8® 8-Bit Microcontroller 
2860117/717 Z8® 8-Bit Microcontroller 
286217 Z8® 8-Bit Microcontroller 

Application Notes 
28602 Keyboard 
286017 In-Mouse Applications 

Support Product Specifications and Third Party Support 
20860200ZC0 Evaluation Board 
20860200ZDP Adaptor Kit 
786C0800ZC0 Evaluation Board 
Z86C0800ZDP Adaptor Kit 
28601200ZEM Emulator 
Z86E2300ZDP Adaptor Kit 
Z86E2301ZDP Adaptor Kit 
Z86E2300ZDV Adaptor Kit 
Z86E2301ZDV Adaptor Kit 

Additional Information 
Zilog's Superintegration™ Products Guide 
Literature Guide and Ordering Information 
Zilog's Sales Offices, Representatives and Distributors 
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Z8®° MICROCONTROLLERS - PERIPHERALS MEMORY FAMILY OF PRODUCTS 
Databooks By Market Niche Part No Unit Cost 


Mass Storage Solutions DC-8303-01 $ 5.00 


Product Specifications 
786021 8K ROM Z8 CMOS Microcontroller 
Z86E21 CMOS Z8 8K OTP Microcontroller 
286091 CMOS Z8 ROMless Microcontroller 
286093 CMOS Z8 Multiply/Divide Microcontroller 
286095 Z8 Digital Signal Processor 
286018 Data Path Controller 
Z89C00 16-Bit Digital Signal Processor 
_ Application Note 
Understanding Q15 Two's Complement Fractional Multiplication (Z89C00 DSP) 
Support Product Specifications 
Z8060000ZC0 Development Kit 
786C1200ZEM In-Circuit Emulator 
Z86E2100ZDF Adaptor Kit 
Z86E2100ZDP Adaptor Kit 
Z86E2100ZDV Adaptor Kit _ 
786E2101ZDF Conversion Kit 
286E2101ZDV Conversion Kit 
Z86C9300ZEM ICEBOX™ Emulator 
286C95002ZC0 Evaluation Board 
78® S Series Emulators, Base Units and Pods 
Z89CO000ZAS Z89C00 Assembler, Linker and Librarian 
Z89C0000ZCC Z89C00 C Cross Compiler 
Z89CO000ZEM In-Circuit Emulator -C00 
289C0000ZSD Z89C00 Simulator/Debugger 
ZPCMCIAOZDP PCMCIA Extender Card 
Additional Information 
Zilog's Superintegration™ Products Guide 
Zilog's Literature Guide 
Zilog's Sales Offices, Representatives and Distributors 
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Z8 Technical Manuals and Users Guides Unit Cost 


Z8® Microcontrollers User's Manual UJM95Z800103 5.00 


286018 Preliminary User's Manual DC-8296-00 N/C 
Digital TV Controller User's Manual DC-8284-01 5.00 
Z89C00 16-Bit Digital Signal Processor User's Manual/DSP Software Manual DC-8294-02 5.00 
286095 16-Bit Digital Signal Processor User Manual DC-8595-02 5.00 
286017 PCMCIA Adaptor Chip User's Manual and Databook DC-8298-03 5.00 
PLC Z89C00 Cross Development Tools Brochure DC-5538-01 N/C 
Z8® Application Notes Part No Unit Cost 
The Z8 MCU Dual Analog Comparator DC-2516-01 N/C 
Z8 Applications for 1/0 Port Expansions DC-2539-01 N/C 
Z86E21 Z8 Low Cost Thermal Printer DC-2541-01 N/C 
Zilog Family On-Chip Oscillator Design DC-2496-01 N/C 
Using the Zilog Z86C06 SPI Bus DC-2584-01 N/C 
Interfacing LCDs to the Z8 DC-2592-01 N/C 
X-10 Compatible Infrared (IR) Remote Control DC-2591-01 N/C 
286017 In-Mouse Applications DC-3001-01 N/C 
2860-40/E40 MCU Applications Evaluation Board DC-2604-01 N/C 
286C08/C17 Controls A Scrolling LED Message Display DC-2605-01 N/C 
286095 Hard Disk Controller Flash EPROM Interface DC-2639-01 N/C 
Three Z8® Applications Notes: Timekeeping with Z8; DTMF Tone Generation; DC-2645-01 N/C 


Serial Communication Using the CCP Software UART 
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Z80°/Z8000® DATACOMMUNICATIONS FAMILY OF PRODUCTS 
Databooks By Market Niche Part No Unit Cost 


High-Speed Serial Communication Controllers DC-8314-01 5.00 
Product Specifications 
Z16C30 CMOS Universal Serial Controller (USC™) (Preliminary) 
216C32 Integrated Universal Serial Controller (IUSC™) (Preliminary) 
Application Notes 
Using the Z16C30 Universal Serial Controller with MIL-STD-1553B 
Design a Serial Board to Handle Multiple Protocols 
Datacommunications 1USC"/MUSC™ Time Slot Assigner 
Support Products and Third Party Vendor Support 
Z16C3001ZC0 Evaluation Board Product Specification 
Z16C032002ZC0 Evaluation Board Product Specification 
28018600ZCO Evaluation Board Product Specification 
ZEPMDC00001 EPM™ Electronic Programmer's Manual Product Specification 
Third Party Vendors 
Additional Information 
Zilog's Superintegration™ Products Guide 
General Terms and Conditions of Sale 
Sales Offices, Representatives and Distributors 


Literature Guide 
Serial Communication Controllers DC-8316-01 5.00 


Product Specifications 
28030/Z8530 Z-Bus® SCC Serial Communication Controller 
Z80030/Z85C30 CMOS Z-Bus® SCC Serial Communication Controller 
280230 Z-Bus® ESCC™ Enhanced Serial Communication Controller (Preliminary) 
785230 ESCC™ Enhanced Serial Communication Controller 
285233 EMSCC™ Enhanced Mono Serial Communication Controller 
785C80 SCSCI™ Serial Communications and Small Computer Interface 
Z16C35/Z85C35 CMOS ISCC™ Integrated Serial Communications Controller 
Application Notes 
Interfacing 28500 Peripherals to the 68000 
SCC in Binary Synchronous Communications 
Zilog SCC Z8030/2Z8530 Questions and Answers 
Integrating Serial Data and SCSI Peripheral Control on One Chip 
Zilog ISCC™ Controller Questions and Answers 
Boost Your System Performance Using the Zilog ESCC™ 
Zilog ESCC™ Controller Questions and Answers 
The Zilog Datacom Family with the 80186 CPU 
On-Chip Oscillator Design 
Support Products 
Z8518000ZC0 Evaluation Board Product Specification 
28523000ZCO0 Evaluation Board Product Specification 
28018600ZCO Evaluation Board Product Specification 
ZEPMDC00002 Electronic Programmer's Manual Software 
Additional Information 
Zilog's Superintegration™ Products Guide 
Sales Offices, Representatives and Distributors 
Literature Guide 
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Z80°/Z8000® DATACOMMUNICATIONS FAMILY OF PRODUCTS 


Databooks Part No Unit Cost 
Z80 Family Databook DC-8321-00 5.00 
Discrete Z80° Family 


28400/C00 NMOS/CMOS Z80® CPU Product Specification 
28410/C10 NMOS/CMOS Z80 DMA Product Specification 
28420/C20 NMOS/CMOS Z80 PIO Product Specification 
28430/C30 NMOS/CMOS Z80 CTC Product Specification 
28440/C40 NMOS/CMOS Z80 SIO Product Specification 
Embedded Controllers 
Z84C01 Z80 CPU with CGC Product Specification 
28470 Z80 DART Product Specification 
284090 CMOS Z80 KIO™ Product Specification 
284013/015 284C13/C15 IPC/EIPC Product Specification 
Application Notes and Technical Articles 
Z80® Family Interrupt Structure 
Using the Z80® S10 with SDLC 
Using the Z80® SIO in Asynchronous Communications 
Binary Synchronous Communication Using the Z80® S10 
Serial Communication with the Z80A DART 
Interfacing Z80® CPUs to the Z8500 Peripheral Family 
Timing in an Interrupt-Based System with the Z80® CTC 
A Z80-Based System Using the DMA with the SIO 
Using the Z84011/C13/C15 in Place of the Z284011/013/015 
On-Chip Oscillator Design 
A Fast Z80® Embedded Controller 
Z80® Questions and Answers 
Additional Information 
Zilog's Superintegration™ Products Guide 
Literature Guide 
Third Party Support Vendors 
Zilog's Sales Offices, Representatives and Distributors 
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Z80*/Z8000° DATACOMMUNICATIONS FAMILY OF PRODUCTS 
Databooks Part No Unit Cost 


Z180™ Microprocessors and Peripherals Databook DC-8322-01 5.00 

Product Specifications 

280180/Z8S180/Z8L180 Z180™ Microprocessor 

280181 Z181™ Smart Access Controller (SAC™) 

280182/Z8L182 Zilog Intelligent Peripheral Controller (ZIP™) 
Application Notes and Technical Articles 

Z180™ Questions and Answers 

2180"/SCC Serial Communication Controller Interface at 10 MHz 

Interfacing Memory and |/0 to the 20 MHz Z8S180 System 

Break Detection on the 280180 and Z181™ 

Local Talk Link Access Protocol Using the 280181 

2182 Programming the MIMIC Autoecho ECHOZ182 Sample Code 

High Performance PC Communication Port Using the Z182 

Improving Memory Access Timing in 2182 Applications 
Support Products 

Z8S18000ZC0 Evaluation Board 

28018100ZC0 Evaluation Board 

28018101ZC0 Evaluation Board 

28018101ZA6 Driver Software 

28018100ZDP Adaptor Kit 

28018200ZC0 Evaluation Board 

ZEPMIP00001 EPM™ Electronic Programmer's Manual 

ZEPMIP00002 EPM Electronic Programmer's Manual 

780® and Z80180 Hardware and Software Support 
Additional Information 

Zilog's Superintegration™ Products Guide 

Literature Guide 

Zilog's Sales Offices, Representatives and Distributors 
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Z80°/Z8000® DATACOMMUNICATIONS FAMILY OF PRODUCTS 


Databooks and User's Manuals Part No 
Z8000 Family of Products DC-8319-00 
28000 Family Databook 


Zilog's 28000 Family Architecture 
28001/Z8002 Z8000 CPU Product Specification 
28016 28000 Z-DTC Product Specification 
28036 28000 Z-CI0 Product Specification 
28536 CIO Counter/Timer and Parallel I/O Unit Product Specification 
28038/Z8538 FIO FIFO Input/Output Interface Unit Product Specification 
28060/Z8560 FIFO Buffer Unit 
28581 Clock Generator and Controller Product Specification 
User's Manuals 
28000 CPU Central Processing Unit User's Manual 
28010 Memory Management Unit (MMU) User's Manual 
28036 Z-C10/28536 CIO Counter/Timer and Parallel Input/Output User's Manual 
78038 28000 Z-FIO FIFO Input/Output Interface User's Manual 
28000 Application Notes and Military Products 
Application Notes 
Using SCC with 28000 in SDLC Protocol 
SCC in Binary Synchronous Communication 
Zilog's Military Products Overview 
Additional Information 
Zilog's Superintegration™ Products Guide 
Literature Guide 
Zilog's Sales Offices, Representatives and Distributors 


Z80 Family Microprocessor Family User's Manual DC-8309-01 
User's Manuals 
Z80 Central Processing Unit (CPU) 
Z80 Counter Timer Channels (CTC) 
Z80 Direct Memory Access (DMA) 
Z80 Parallel Input/Output (PIO) 
Z80 Serial Input/Output (SIO) 
Additional Information 
Zilog's Superintegration™ Products Guide 
Zilog's Sales Offices, Representatives and Distributors 
Literature Guide 


Unit Cost 
5.00 


9.00 
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Databooks and User's Manuals Part No Unit Cost 
280180 Z180 MPU Microprocessor Unit Technical Manual DC-8276-04 5.00 
2280 MPU Microprocessor Unit Technical Manual DC-8224-03 5.00 
Z380™ Product Specification DC-6003-03 N/C 
7380™ User's Manual P$953800104 5.00 
22000 Spread-Spectrum Transceiver Advance Information Product Specification DC-6021-00 N/C 
ZNW2000 PC WAN Adapter Board Development Kit User's Manual UM95Z800101 N/C 
SCC Serial Communication Controller User's Manual DC-8293-02 5.00 
High-Speed SCC, 216C30/216C32 User's Manual DC-8350-00 5.00 
MILITARY COMPONENTS FAMILY 

Military Product Specifications PartNo Unit Cost 
28681 ROMless Microcomputer DC-2392-02 N/C 
28001/8002 Military Z8000 CPU Central Processing Unit DC-2342-03 N/C 
28581 Military CGC Clock Generator and Controller DC-2346-01 N/C 
28030 Military Z8000 Z-SCC Serial Communications Controller DC-2388-02 N/C 
28530 Military SCC Serial Communications Controller DC-2397-02 N/C 
28036 Military 28000 Z-CIO Counter/Timer Controller and Parallel 1/0 DC-2389-01 N/C 
28038/8538 Military FIO FIFO Input/Output Interface Unit DC-2463-02 N/C 
78536 Military ClO Counter/Timer Controller and Parallel 1/0 DC-2396-01 N/C 
28400 Military Z80 CPU Central Processing Unit DC-2351-02 N/C 
28420 Military PIO Parallel Input/Output Controller DC-2384-02 N/C 
78430 Military CTC Counter/Timer Circuit DC-2385-01 N/C 
28440/1/2/4 Z80 SIO Serial Input/Output Controller DC-2386-02 N/C 
Z80030/85C30 Military CMOS SCC Serial Communications Controller DC-2478-02 N/C 
Z84C00 CMOS Z80 CPU Central Processing Unit DC-2441-02 N/C 
284020 CMOS Z80 PIO Parallel Input/Output DC-2384-02 N/C 
284030 CMOS Z80 CTC Counter/Timer Circuit DC-2481-01 N/C 
784C40/1/2/4 CMOS Z80 SIO Serial Input/Output DC-2482-01 N/C 
Z16C030 CMOS USC Universal Serial Controller (Preliminary) DC-2531-01 N/C 
280180 2180 MPU Microprocessor Unit DC-2538-01 N/C 
Z84C90 CMOS KIO Serial/Parallel/Counter Timer (Preliminary) DC-2502-00 N/C 
785230 ESCC Enhanced Serial Communication Controller DC-2595-00 N/C 
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GENERAL LITERATURE 


Catalogs, Handbooks, Product Flyers and Users Guides 


Superintegration Master Selection Guide 1994-1995 
Superintegration Products Guide 
Quality and Reliability Report 


ZIA™ 3.3-5.5V Matched Chip Set for AT Hard Disk Drives Datasheet 


ZIA ZIAQOZCO Disk Drive Development Kit Datasheet 
Zilog Hard Disk Controllers - Z86C93/C95 Datasheet 
Zilog Infrared (IR) Controllers - ZIRC™ Datasheet 
Zilog V. Fast Modem Controller Solutions 

Zilog Digital Signal Processing - 289320 Datasheet 
Zilog Keyboard Controllers Datasheet 

7380" - Next Generation Z80®/Z180™ Datasheet 
Fault Tolerant Z8® Microcontroller Datasheet 

32K ROM Z8® Microcontrollers Datasheet 

Zilog Datacommunications Brochure 

289300 DTC Controller Family Brochure 

Zilog Digital Signal Processing Brochure 

Zilog ASSPs - Partnering With You Product Brochure 
Zilog Wireless Products Datasheet 

Zilog 28604 Cost Efficient Datasheet 

Zilog Chip Carrier Device Packaging Datasheet 

Zilog Database of IR Codes Datasheet 

Zilog PCMCIA Adapter Chip 286017 Datasheet 

Zilog Television/Video Controllers Datasheet 

Zilog TAD Controllers - 289C65/C67/C69 Datasheet 
Zilog Z87000 Z-Phone Datasheet 

Zilog 1993 Annual Report 

Zilog 1994 Annual Report 


Part No 


DC-5634-01 
DC-5676-00 
DC-8329-01 
DC-5556-01 
DC-5593-01 
DC-5560-01 
DC-5558-01 
DC-5525-02 
DC-5547-01 
DC-5600-01 
DC-5580-02 
DC-5603-01 
DC-5601-01 
DC-5519-00 
DC-5608-01 
DC-5536-02 
DC-5553-01 
DC-5630-00 
DC-5662-00 
DC-5672-00 
DC-5631-00 
DC-5585-01 
DC-5567-01 
DC-5561-02 
DC-5632-00 
DC-1993-AR 
DC-1994-AR 
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Unit Cost 


N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
N/C 
D/C 
N/C 
N/C 
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